✍️Transactions status

Vault Deposit Status.

  GET /defi-vaults/v1/defi/vault/:vaultAddress/deposit-status

Returns the current status of a user's deposit request in an async vault. This endpoint reads on-chain ERC7540 state to determine where the deposit is in the settlement lifecycle.

Path Parameters

Parameter	Description
vaultAddress	Vault contract address

Query Parameters

Parameter	Description
userAddress	User's wallet address

Response

  {
    "vaultAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "userAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "chainId": 8453,
    "status": "claimable",
    "statusDescription": "Curator has settled the epoch — shares are ready to claim via mint()",
    "amounts": {
      "pendingDeposit": "0",
      "claimableShares": "1000000000000000000",
      "currentShares": "0"
    },
    "vault": {
      "depositEpochId": 3,
      "isTotalAssetsValid": true
    }
  }

Response Fields

Field	Type	Description
vaultAddress	string	Vault contract address
userAddress	string	User's wallet addres
chainId	number	Chain ID where the vault is deployed
status	string	Current deposit status
statusDescription	string	Human-readable description of the status
amounts.pendingDeposit	string	Assets waiting for curator settlement (wei)
amounts.claimableShares	string	Shares ready to claim (wei)
amounts.currentShares	string	Shares already in user's wallet (wei)
vault.depositEpochId	number	Current deposit epoch ID
vault.isTotalAssetsValid	boolean	Whether the vault's total assets valuation is valid

Status	Description
pending	Deposit request submitted, awaiting curator settlement
claimable	Curator has settled the epoch — shares are ready to claim
deposited	Shares have been claimed and are in the user's wallet
no_active_deposit	No pending or claimable deposit found for this user

Status Values

Get Deposit Status

GET /defi-vaults/v1/defi/deposit/:txHash/status

Returns the status of a cross-chain deposit. This endpoint abstracts the underlying bridge provider, giving you a unified view of your transaction.

Path Parameters

Parameter	Description
txHash	Source chain transaction hash

Query Parameters

Parameter	Required	Description
srcChainId	Yes	Source chain ID where the deposit was initiated

Response

{
  "depositId": "0x5bf5439b6f74c1d003e9807c5b8876fe2f1668d276b85919040c6c40608b466b",
  "status": "completed",
  "srcChain": {
    "id": 1,
    "name": "Ethereum"
  },
  "destChain": {
    "id": 8453,
    "name": "Base"
  },
  "protocol": null,
  "inputAmount": null,
  "outputAmount": null,
  "timestamps": {
    "initiated": null,
    "bridged": null,
    "completed": null
  },
  "transactions": {
    "source": "0x5bf5439b6f74c1d003e9807c5b8876fe2f1668d276b85919040c6c40608b466b",
    "fill": "0xd1da0b500dcb97f1f8d92013c2588888439ddd08015e4d60604298935d70bb66"
  }
}

Response Fields

Field	Type	Description
depositId	string	Source transaction hash (identifier)
status	string	Current status (see below)
srcChain	object	Source chain info
srcChain.id	number	Source chain ID
srcChain.name	string	Source chain name
destChain	object	Destination chain info
destChain.id	number	Destination chain ID
destChain.name	string	Destination chain name
protocol	string | null	Target protocol (if known)
inputAmount	string | null	Amount sent (if known)
outputAmount	string | null	Amount received (if known)
timestamps.initiated	string | null	ISO timestamp when deposit was initiated
timestamps.bridged	string | null	ISO timestamp when bridge fill occurred
timestamps.completed	string | null	ISO timestamp when fully complete
transactions.source	string	Source chain transaction hash
transactions.fill	string | null	Fill transaction hash on destination chain

Status Values

Status	Description
pending	Transaction submitted, waiting for bridge to index
bridging	Bridge is processing the cross-chain transfer
completed	Funds successfully delivered to destination and deposited
failed	Transaction expired, refunded, or failed

Status Flow

pending --> bridging --> completed
                    \--> failed

Errors

Status	Error	Description
400	Missing required parameter: txHash	No transaction hash provided
400	Invalid txHash	Not a valid transaction hash format
400	Missing required query parameter: srcChainId	No source chain ID provided
400	Invalid srcChainId	Not a valid number
400	Unsupported srcChainId	Chain not supported

Verifying on Block Explorer

Once you have the fill transaction hash, you can verify on the destination chain's block explorer:

• Ethereum: https://etherscan.io/tx/{fill}

• Base: https://basescan.org/tx/{fill}

• Arbitrum: https://arbiscan.io/tx/{fill}