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. This service only moves funds to/from the treasury on behalf of the user.

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

1. 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.

2. 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.

3. 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.

4. 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 - user account in NEAR Intents

• 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 - user account in NEAR Intents

• 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 - user account NEAR Intents

• [].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 (COMPLETED, PENDING, FAILED, NOT_FOUND, AWAITING, REJECTED, RETURNING, RETURNED)

• data.tx_hash - burn transaction hash on NEAR

• data.transfer_tx_hash - transfer transaction hash on destination chain

• data.chain - network type and chain id

• data.defuse_asset_identifier - token identifier

• data.decimals - token decimals

• data.amount - asset amount

• data.account_id - 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"
    "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 estimates the fees for transactions.

Parameters

• chain - The blockchain network in format {network}:{chainId}

• token - The token identifier for which to estimate withdrawal fees

• address - Recipient 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
    }
  }
}