v1

latestSwagger 2.02026-07-17127100479.5 KB

forwarding

List forwarding events

Returns a paginated list of forwarding events. Forwarding events represent cross-domain token transfers where tokens are forwarded from a Celestia address to a destination address on another domain. Results can be filtered by transaction hash, address, or block height.

get/forwarding

Query parameters

limitinteger

Count of requested entities

offsetinteger

Offset for pagination

sort'asc' | 'desc'

Sort order. Default: desc

tx_hashstring

Filter by transaction hash (hex)

addressstring

Filter by Celestia address

heightinteger

Filter by block height

frominteger

Filter by start time (Unix timestamp)

tointeger

Filter by end time (Unix timestamp)

Response

amountstring string

denomstring string

dest_addressstring binary

dest_domaininteger

heightinteger

idinteger

message_idstring string

timestring date-time

token_idstring string

tx_hashstring binary

Example response

[
  {
    "amount": "1000000",
    "chain": {
      "block_explorers": [
        {
          "api_url": "https://api.scan.url.io",
          "family": "etherscan",
          "name": "Block explorer",
          "url": "https://scan.url.io"
        }
      ],
      "name": "name",
      "native_token": {
        "decimals": 18,
        "name": "Ether",
        "symbol": "ETH"
      }
    },
    "denom": "hyperlane/0x726f757465725f61707000000000000000000000000000020000000000000024",
    "dest_address": "0x000000000000000000000000d5e85e86fc692cedad6d6992f1f0ccf273e39913",
    "dest_domain": 11155111,
    "forward_address": {
      "celestials": {
        "image_url": "https://ipfs.io/ipfs/QmUi269vE25fagqhyMCCTNSoiW6x4LHCwwQb3keSrEXAmC",
        "name": "name",
        "primary": true,
        "status": "VERIFIED"
      },
      "hash": "celestia1jc92qdnty48pafummfr8ava2tjtuhfdw774w60"
    },
    "height": 100,
    "id": 321,
    "inputs": [
      {
        "chain": {
          "block_explorers": [
            {
              "api_url": "https://api.scan.url.io",
              "family": "etherscan",
              "name": "Block explorer",
              "url": "https://scan.url.io"
            }
          ],
          "name": "name",
          "native_token": {
            "decimals": 18,
            "name": "Ether",
            "symbol": "ETH"
          }
        },
        "denom": "utia",
        "from": "0x000000000000000000000000123456789abcdef123456789abcdef12345609",
        "height": 100,
        "received": "123445",
        "time": "2023-07-04T03:10:57+00:00",
        "tx_hash": "652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF"
      }
    ],
    "message_id": "0xac8852bd411c0c88cdadfe9b2386b2bcd702f35479c25a4b2d2cc3fb49d095d4",
    "time": "2023-07-04T03:10:57+00:00",
    "token_id": "12652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF345",
    "tx_hash": "652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF"
  }
]