✍️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

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

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

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}

Last updated