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.