/bridge/transfers/transactions/:hash

You need an API key for this call. Please reach out to the Blessnet team to get setup.

GET /bridge/transfers/transactions/:hash

The /bridge/transfers/transactions/:hash endpoint returns bridge transfer data for a particular transaction has. This will return a single record. The transaction has can match any of the hashes involved in the route (i.e. the origin hash, the wormhole submission hash, the rollup bridge submission hash or the delivery hash).

Headers

Name	Value
x-api-key	Your API key

Params

Name	Mandatory?	Default	Value
chain	No	mainnet	The chain type we are working with, either mainnet or sepolia

Path Variables

Name	Mandatory?	Default	Value
:hash	Yes		The hash you are querying

Response Body

The response provides an array of bridgeData objects with a single entry representing the transfer that contains the transaction hash.

The bridgeData objects have the following properties:

Name	Type	Description
_id	string	The unique Id for this transfer
type	string	The type of transfer, e.g. BLESS, ERC20. Possible values: - BLESS - ERC20 - ERC721 - ERC1155 - TXN
status	string	The overall status of the transfer, including all nodes on the route. Possible values: done (transfer complete) - wait-wh (awaiting wormhole completion. - wait-rb (awaiting rollup bridge completion) - wait-cc (awaiting child chain confirmation) - manual (awaiting manual confirmation) - error
fromChain	string	The origin chain.
toChain	string	The destination chain.
fromAddress	string	The address that has initiated the transfer.
toAddress	string	The address the transfer is going to.
originTimestamp	number	The timestamp from the first transaction in this transfer.
blessAmount	string	The amount of BLESS being send, if this is a BLESS transfer.
tokenContract	string	The address of the contract for the token being send, if this is a token transfer.
tokenAmount	string	The amount of token being sent, if this is a token transfer.
tokenIds	array	An array of the token Ids being sent, if this is an ERC721 or ERC1155 transfer.
originTxnHash	string	The transaction hash of the first transaction in this transfer.
whTxnHash	string	The transaction hash of this transfer being submitted to wormhole (will only be present if wormhole is used in the route).
rbTxnHash	string	The transaction hash of this transfer being submitted to the rollup bridge (will only be present if the rollup bridge is used in this route).
deliveryTxnHash	string	The transaction hash of this transfer being delivered to the destination chain.
route	array	An array of objects describing the route of this transaction and the hashes at each step, if that step has been completed.

Example Request

GET https://api.bless.net/bridge/transfers/transactions/:hash?chain=sepolia

Response

200

{
    "bridgeData": {
        "bridgeData": [
            {
                "_id": "67b668f3cf1e3ed7138c575d",
                "type": "ERC20",
                "chainType": "sepolia",
                "status": "done",
                "fromChain": 11155111,
                "toChain": 421614,
                "fromAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
                "toAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
                "originTimestamp": 1739960856,
                "tokenContract": "0xaF5a391579CA5D05e388a333c3D7e2823Ab3Ff7e",
                "tokenAmount": "1000000000000000000",
                "originTxnHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76",
                "whTxnHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76",
                "deliveryTxnHash": "0xd870621d41463c57e78ab4435c55661894268401ad21b1fcbf70d6110376591b",
                "route": [
                    {
                        "step": 11155111,
                        "txHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76"
                    },
                    {
                        "step": "wormhole",
                        "txHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76"
                    },
                    {
                        "step": 421614,
                        "txHash": "0xd870621d41463c57e78ab4435c55661894268401ad21b1fcbf70d6110376591b"
                    }
                ]
            }
        ],
        "nextCursor": null
    }
}