Jigu (지구)
The Python SDK for Terra.
Docs | Examples | Contributing
Installation
Jigu requires Python 3.7+. Install the latest version of Jigu with pip
on PyPI:
$ pip install -U jigu
Pretty Printing
Many objects in Jigu are pretty-printable by their ._pp
property.
Python 3.7.6 (default, Dec 30 2019, 19:38:26) >>> from jigu import Terra >>> terra = Terra("columbus-3", "https://lcd.terra.dev/") >>> terra.market.params()._pp ╒═════════════════════════╤═════════════════╕ │ pool_recovery_period │ 14400 │ ├─────────────────────────┼─────────────────┤ │ base_pool │ 250000000000 │ ├─────────────────────────┼─────────────────┤ │ min_spread │ 0.02 │ ├─────────────────────────┼─────────────────┤ │ tobin_tax │ 0.0025 │ ├─────────────────────────┼─────────────────┤ │ illiquid_tobin_tax_list │ ╒══════╤══════╕ │ │ │ │ umnt │ 0.02 │ │ │ │ ╘══════╧══════╛ │ ╘═════════════════════════╧═════════════════╛
works by default in Jupyter ...
My First Transaction
Connect to Soju testnet
Once you've installed Jigu, fire up an interactive Python shell and connect to the Soju testnet using the official Soju node provided by Terraform Labs.
from jigu import Terra
soju = Terra("soju-0013", "https://soju-lcd.terra.dev")
assert soju.is_connected()
Create an account
Before we can make any transactions, we have to have an account. Enter in the above to create an account and print its account address.
from jigu.key.mnemonic import MnemonicKey
wallet = soju.wallet(MnemonicKey.generate())
wallet.address
# terra17w4ppj92dwdf93jjtply08nav2ldzw3z2l3wzl
Top off with testnet funds
Great, now that we have an address, let's get some testnet funds. Head over to the Soju Faucet and top off some Luna.
After that's done, you should have 10,000 LUNA in your account. To confirm this, you can enter the following:
wallet.balance("uluna")
# Coin('uluna', 10000000000)
Create a transaction
Let's send 23 Testnet Luna to your friend at the following address:
terra1wg2mlrxdmnnkkykgqg4znky86nyrtc45q336yv
We'll need to create a transaction containing a MsgSend
alongside a short memo (note) "Hello Jigu!" -- our version of Hello World.
from jigu.core import Coins, StdFee
from jigu.core.msg import MsgSend
send = MsgSend(
from_address=wallet.address,
to_address="terra1wg2mlrxdmnnkkykgqg4znky86nyrtc45q336yv",
amount=Coins(uluna=23_000_000)
)
fee = StdFee.make(50000, uluna=1000) # include a small fee..
tx = wallet.create_and_sign_tx(send, memo="Hello Jigu!", fee=fee)
res = wallet.broadcast(tx)
See it on the blockchain
It should take around 6 seconds to finalize. If everything went well, you should get a result object with the height and TX hash after about 6 seconds.
print(f"TX Hash: {res.txhash}")
# TX Hash: 82D5440A4C4CAB5B74EE3C98CE7F755372CD92E945425A572654179A4A0EE678
Copy the TX hash and enter it on Finder, selecting the chain soju-0013
.
Learn more
Check out the official documentation at https://jigu.terra.money.
License
This software is licensed under the MIT license. See LICENSE for full disclosure.
© 2020 Terraform Labs, PTE.