Integration Overview
Dashboards, explorers etc
Connect to Midgard to get rich data about the system, included time-series graphs and aggregated values like TotalVolume etc.
Connect to THORNode (or proxied via Midgard) to drill into the state-machine and access the current state (or historical just by adding a
?height=1234to specify a certain height.Connect to RPC to get information about the Ledger, which is not specific to THORChain, such as
/genesisor account/transaction information
Wallets, interfaces etc.
These applications require first-principle thinking and excellent understanding of how the system works.
Connect to a trusted THORNode or connect to several public THORNodes and ensure they all agree
Get the
/inbound_addressesCompose the transaction with the correct memo and correct gas price.
Send the vault the transaction and wait for execution
First, you need to connect to THORChain. You can use the official clients which have SSL, or run your own node, host it on SSL.
If you don't need SSL, you can connect to any of the non-SSL public nodes (ie, just their IP address). Web applications need SSL, but mobile and desktop apps don't.
Vaults are fetched from the /inbound_addresses endpoint.
If you connect to public THORNodes, you must be conscious of the fact that you can be phished and could send money to the WRONG vault. You should do safety checks, ie, comparing with other nodes, or even inspecting the vault itself for presence of funds.
Never cache vault addresses, they churn regularly.
Check for the halted parameter and never send funds if it is set to true
The most important details in the transaction:
{"from":"", // the user"to":"", // the vault"amount:"", // the amount to send (swap, add liquidity)"memo":"", // the transaction intent"gas_rate":"" // always set to next-block rates}
The memos can be found here:
Always use a "fast" or "fastest" fee, if the transaction is not confirmed in time, it could be abandoned by the network. You should allow your users to cancel or re-try with higher fees.
You can user any wallet library, like bitcoinjs or use the xchainjs which wraps all the respective chains.
