🐲
Dragon SDK
With dragon you can track failing and successful web3 client transactions for debugging as well as analytics. Transactions that fail in the client cannot be found in a block explorer.
- json RPC responses, especially error messages, in the UI are cryptic
- to understand whether errors impacting users are a bug in the frontend or the smart contract
- to get better analytics about the wallets interacting with your dApp
- to understand if wallets are interacting with your smart contracts through your dApp frontend or through their own scripts, which can especially be helpful for security
All dragon data can be queried for monitors as well as in the log explorer. For successful transactions we automatically contextualize your transaction logs with dragon data to show the full end-2-end trace
npm install @blocktorch/0xdragon
or if you prefer yarn
yarn add @blocktorch/0xdragon
import { Dragon } from '@blocktorch/0xdragon'
const dragon = new Dragon({
projectId: <your-project-id>,
apiKey: <your-blocktorch-api-key>
})
In the constructor you can also specify additional options:
contractName(string) - default identifier for what the transactions are interacting with. Default is "unknown"chainId(number) - chain ID of the applicationhttp(object):maxRetries(number) - number of times failed SDK requests are retrieddelay(number) - number of times failed SDK requests are retriedexponentialBackoff(boolean) - Whether to allow exponential backoff or not
Initialize the tracking of a single transaction
const id = dragon.init()
You can override options per transaction.
contract(string) - identifier for what the transaction is interacting withchainId(number) - id of the blockchain
Track the transaction as a success. Should be done after the transaction is accepted on chain.
await dragon.success(id, transaction)
Track the transaction as an error
await dragon.error(id, error)
If you are using ethers@5 or any other compatible libraries you can use a helper function to wrap your whole transaction and it will detect success or failure itself. It will wait until the transaction receipt is received to mark it as a success.
await dragon.wrap(
contract.doSmth({ value: ethers.utils.parseEther("0.1") })
)
You can also specify the following options:
contract(string) - identifier for what the transaction is interacting withchainId(number) - id of the blockchain
Last modified 28d ago