Passive Deposit/Withdrawal Service

The Passive Deposit/Withdrawal Service enables seamless asset movement between supported blockchain networks and NEAR Intents. It provides a lightweight mechanism for moving tokens in and out of the protocol.

There is an SDK for integrating the Passive Deposits/Withdrawals Service: Bridge SDK on GitHub. This SDK is under active development and may introduce breaking changes.

How to use

Get supported assets. The service only works with a specific list of tokens that are available for transfer to NEAR Intents. The list of supported tokens and networks can be obtained using this request.
Get deposit address. Once you have verified that your token is supported by the service, you can use the request to obtain a deposit address. After receiving the address, transfer the tokens to it, and they will soon be available in NEAR Intents.
Get recent deposit. The API service allows you to get the status of the most recent deposits. Simply send a request to retrieve this information.
Get withdrawal status. The service supports token withdrawals from NEAR Intents to the supported network. To do this, call the 'withdrawal' contract method or use the frontend. The status of the withdrawal can be obtained upon request.

JSON-RPC Endpoint

POST: https://bridge.chaindefuser.com/rpc

Requests

1. Get supported assets

Returns a list of tokens that are supported by the service in each network.

Parameters

[]chains - chain filter.

Response

[].tokens.defuse_asset_identifier — unique id of trading asset
[].tokens.near_token_id — unique id of the token in the NEAR blockchain
[].tokens.decimals — trading asset precision. should be used for amount setup during intent creation
[].tokens.asset_name — trading asset name
[].tokens.min_deposit_amount — minimum amount of tokens to trigger transfer process
[].tokens.min_withdrawal_amount — minimum amount of tokens to initiate a withdrawal
[].tokens.withdrawal_fee — the fee charged for withdrawing the specified token

Example

// Request
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "supported_tokens",
  "params": [
    {
      "chains": ["CHAIN_TYPE:CHAIN_ID", "..."], //optional
    }
  ]
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
   "tokens": [
     {
       "defuse_asset_identifier" : "eth:8453:0x123", //CHAIN_TYPE:CHAIN_ID:ADDRESS
       "near_token_id": "...",
       "decimals" : 18,
       "asset_name" : "PEPE",
       "min_deposit_amount": "100000"
       "min_withdrawal_amount": "10000"
       "withdrawal_fee": "1000"
     },
     // ...
     ]
   }
}

2. Get deposit address

Returns the address for depositing supported tokens or native currency.

Parameters

account_id - Defuse user account
chain - network type and chain id. E.g. eth:42161 for Arbitrum or btc:mainnetfor Bitcoin.

Response

address - deposit address
chain - network type and chain id.

Example

//Request
{
  "jsonrpc": "2.0", 
  "id": 1, 
  "method": "deposit_address", 
  "params": [ 
    {
      "account_id": "user.near",
      "chain": "CHAIN_TYPE:CHAIN_ID"
    }
  ]
}

//Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "address": "0x....",
    "chain": "CHAIN_TYPE:CHAIN_ID"
  }
}

3. Get recent deposits

Returns information on recent deposits

Parameters

account_id - Defuse user account
chain - network type and chain id.

Response

[].tx_hash - Transaction hash [EVM networks only]
[].chain - network type and chain id.
[].defuse_asset_identifier - token identifier
[].decimals - token decimals
[].amount - asset amount
[].account_id - Defuse user account
[].address - deposit address
[].status - deposit status

Example

//Request
{
  "jsonrpc": "2.0", 
  "id": 1, 
  "method": "recent_deposits", 
  "params": [ 
    {
      "account_id": "user.near",
      "chain": "CHAIN_TYPE:CHAIN_ID"
    }
  ]
}

//Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "deposits": [
      {
        "tx_hash": "",
        "chain": "CHAIN_TYPE:CHAIN_ID",
        "defuse_asset_identifier": "eth:8543:0x123",
        "decimals": 18,
        "amount": 10000000000,
        "account_id": "user.near",
        "address": "0x123",
        "status": "COMPLETED" // PENDING, FAILED
      },
    ]
  }
}

4. Get withdrawal status

Returns withdrawal status.

Parameters

withdrawal_hash - hash of the transaction on NEAR where ft_burn event happened on the token contract

Response

status - withdrawal status
data.tx_hash - NEAR transaction hash
data.transfer_tx_hash - Transfer transaction hash
data.chain - network type and chain id.
data.defuse_asset_identifier - token identifier
data.decimals - token decimals
data.amount - asset amount
data.account_id - Defuse user account
data.address - withdrawal address

Example


// Request
{
  "jsonrpc": "2.0", 
  "id": 1, 
  "method": "withdrawal_status", 
  "params": [ 
    {
      "withdrawal_hash": "some_hash",
    }
  ]
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": "COMPLETED" // NOT_FOUND, PENDING, FAILED
    "data": {
      "tx_hash": "some_hash",
      "transfer_tx_hash": "", // if exists
      "chain": "CHAIN_TYPE:CHAIN_ID",
      "defuse_asset_identifier": "eth:8543:0x123",
      "decimals": 18,
      "amount": 10000000000,
      "account_id": "user.near",
      "address": "0x123"
    }
  }
}

5. Notify about deposit transaction hash

Optional method that notifies service about your deposit.

Parameters

deposit_address - address which you received from service api previously and where you transferred tokens
tx_hash - hash of your deposit transaction

Response

error- optional field in case of wrong input

Example


// Request
{
  "jsonrpc": "2.0", 
  "id": 1, 
  "method": "notify_deposit", 
  "params": [ 
    {
      "deposit_address": "address",
      "tx_hash": "hash"
    }
  ]
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1
}

6. Estimated withdrawal fees

Convenience method that estimate amount of fees for transactions.

Parameters

chain - The blockchain network in format {network}:{chainId}
token - The token identifier for which to estimate withdrawal fees
address - Recepient address

Response

tokenAddress- The address of the token contract
userAddress - The user's address
withdrawalFee - The estimated fee for withdrawal
withdrawalFeeDecimals- The decimal precision of the withdrawal fee
token- Token information details
error- Error message if estimation fails

Example


// Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "withdrawal_estimate",
  "params": [
    {
      "chain": "eth:1",
      "token": "eth.omft.near",
      "address": "0x456def..."
    }
  ]
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tokenAddress": "0x123abc...",
    "userAddress": "0x456def...",
    "withdrawalFee": "12500000000000000",
    "withdrawalFeeDecimals": 18,
    "token": {
      "defuse_asset_identifier": "0x123abc...",
      "near_token_id": "eth.omft.near",
      "decimals": 18,
      "asset_name": "ETH",
      "min_deposit_amount": 0.001
    }
  }
}

PreviousUsage NextVerifier

Last updated 0 minutes ago