Komodo DeFi SDK Common Structures
The objects are in the request or response of multiple Komodo DeFi SDK methods have been grouped into the following sections:
Structures which are used in more than one section are listed below:
The NumericFormatsValue returns a price or amount in three different formats: fraction, rational, and decimal.
| Parameter | Type | Description |
|---|---|---|
| decimal | numeric string | A decimal number as a string. |
| rational | object | A standard RationalValue object. |
| fraction | object | A standard FractionalValue object. |
The FractionalValue object includes a numerator and denominator values for a given price or amount:
| Parameter | Type | Description |
|---|---|---|
| numer | string (numeric) | The numerator of the fractional value. |
| denom | string (numeric) | The denominator of the fractional value. |
For requests which return many results, pagination offsets may be applied. ** Use either value, not both. **
| Parameter | Type | Description |
|---|---|---|
| PageNumber | integer | Optional, defaults to 1. Offset for paginated results |
| FromId | integer | Optional. Ignores any results prior to this UUID |
The Komodo DeFi SDK now offers the num-rational crate feature which allows for higher precision numeric values to represent order volumes and prices in a unique format as explained below:
[
[1, [0, 1]],
[1, [1]]
]
In the above unique format, the first item [1,[0,1]] is the numerator and the second item [1,[1]] is the denominator.
The numerator and denominator are BigInteger numbers represented as a sign and a uint32 array (where numbers are 32-bit parts of big integer in little-endian order).
[1,[0,1]] represents +0000000000000000000000000000000010000000000000000000000000000000 = 4294967296
[-1,[1,1]] represents -1000000000000000000000000000000010000000000000000000000000000000 = -4294967297
You can optionally apply more detailed configuration to event streaming methods.
| Parameter | Type | Description |
|---|---|---|
| stream_interval_seconds | float | Interval in seconds between streaming event update requests. Defaults to 10 for stream::balance::enable and 5 for stream::network::enable/stream::heartbeat::enable |
| always_send | boolean | stream::network::enable only. Optional, defaults to false. If true, network data will always be sent every stream_interval_seconds, even when there is no change. If false, network data will be sent regardless. |
The EventStreamConfig object defines which events will be streamed to the client:
| Parameter | Type | Description |
|---|---|---|
| access_control_allow_origin | string | Defines CORS whitelist. Use "*" to allow from any origin. |
| worker_path | string | WASM only. Path to a custom worker.js file. |
Configurable events, and how to enable them, is detailed in the streaming methods doc
An example of the event stream output can then be viewed in https://github.com/KomodoPlatform/komodo-defi-framework/blob/main/examples/sse/index.html?id=CLIENT_ID
The CLIENT_ID value used in the url must match the client_id value used when enabling streaming events. In the case of a single client only, defining the client_id is not required (it will default to 0).
| Parameter | Type | Description |
|---|---|---|
| state | string | current state of sync; possible values: NotEnabled, NotStarted, InProgress, Error, Finished |
| additional_info | object | A standard SyncStatusExtended object. Additional info that helps to track the progress; present for InProgress and Error states only. |
| Parameter | Type | Description |
|---|---|---|
| blocks_left | number | present for ETH/ERC20 coins only; displays the number of blocks left to be processed for InProgress state |
| transactions_left | number | present for UTXO coins only; displays the number of transactions left to be processed for InProgress state |
| code | number | displays the error code for Error state |
| message | number | displays the error message for Error state |
The 'FilterCriteria' object allows you to filter the results based on specific parameters.
| Parameter | Type | Description |
|---|---|---|
| status | string | Status of the transactions (e.g., "completed") |
| date_from | string | `Start date in ISO 8601 format |
| date_to | string | End date in ISO 8601 format |
| my_coin | string | Coin being used by you for the swap/trade. |
| other_coin | string | Coin you are trading against |
| from_timestamp | number | Start timestamp in UNIX format |
| to_timestamp | number | End timestamp in UNIX format |
The PagingOptions object includes options of page selection to consult when looking for recent swaps:
| Parameter | Type | Description |
|---|---|---|
| from_uuid | string (or null) | Skips records until this UUID, excluding the record with this UUID. Convenient for infinite scrolling implementations. |
| limit | number | Limits the number of returned swaps. |
| page_number | number | Returns limit swaps from the selected page. This parameter is ignored if from_uuid is set. |
The WcConnNs object contains details of approved chains, methods and events while connected via WalletConnect.
| Parameter | Type | Description |
|---|---|---|
| chains | list of strings | A list of chain IDs. For EIP155, refer to https://chainid.network/. For Cosmos, refer to https://cosmos.directory/ |
| methods | list of strings | A list of approved methods, usable while connected. For EIP155, refer to https://docs.reown.com/advanced/multichain/rpc-reference/ethereum-rpc. For Cosmos, refer to https://docs.reown.com/advanced/multichain/rpc-reference/cosmos-rpc |
| events | list of strings | A list of events to track during the connection. For EIP155, refer to https://docs.reown.com/advanced/providers/ethereum#events. For Cosmos, refer to https://tutorials.cosmos.network/academy/2-cosmos-concepts/10-events.html |
The WcSession object contains details of active WalletConnect sessions.
| Parameter | Type | Description |
|---|---|---|
| topic | string | The session topic hex string, used to identify the session for communications with the external wallet/dapp. |
| metadata | object | Arbitrary data returned from the external wallet/dapp on connection. |
| pairing_topic | string | The pairing topic hex string, used for the initial external wallet/dapp connection. |
| namespaces | object | Contains the same two WcConnNs objects for Cosmos/EIP155 which were input when initialising the connection via wc_new_connection. |
| expiry | integer | A timestamp in unix epoch format indicating when the connection will expire if not otherwise closed. |
Within each session object, there are a some values which are required as input in other WalletConnect methods:
pairing_topic: Only used when initally connecting with external wallets/dapps.topic: Once connected, this is use for communications with the connected external wallet/dapp.