blessnet docs
  • Welcome to Blessnet
  • Getting Started
    • Quickstart
  • Reference
    • Blessnet Chain Details
    • Supported Chains
    • Contract Addresses
  • BLESS Token
    • BLESS
    • Get BLESS
    • BLESS Sepolia Faucet
    • BLESS Sprinkler
    • BLESS Dispenser
    • BLESS Bridge
  • Blessnet Apps
    • Attestations
    • Ethereals
    • Mirrors
    • Modular Permissions
    • Transaction Bridge
  • Papers and Articles
    • Whitepaper
  • Tech
    • Technical Reference
  • Blessnet API
    • Blessnet API URLs
    • /account-abstraction/operations
    • /account-abstraction/operations/accounts/:address
    • /account-abstraction/platforms/:platform/accounts/:id
    • /account-abstraction/platforms/:platform/accounts
    • /addresses/:address/delegates
    • /addresses/:address/permissions
    • /addresses/:address/vaults
    • /project
    • /bridge/transfers
    • /bridge/transfers/transactions/:hash
    • /deliveries/:id
    • /ethereals
    • /ethereals/:chainId/:address
    • /sprinkles
    • /tokens/:address/:id/uri
    • Block Scan API
  • Contract ABI
    • Attestions.sol
Powered by GitBook
On this page
  • Headers
  • Path Variables
  • Response Body
  • Example Request
  • Response
  1. Blessnet API

/ethereals/:chainId/:address

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

GET /ethereals/:chainId/:address

The /etherals/:chainId/:address endpoint returns details of a specific ethereal account.

Headers

Name
Value

x-api-key

Your API key

Path Variables

Name
Mandatory?
Default
Value

:chainId

Yes

the chain the source token lives on

:address

Yes

The source token address you are querying

Response Body

The response provides an ethereal object structured as follows:

Name
Type
Description

_id

string

The unique Id for this transfer

ethereal

string

The contract address of the ethereal collection.

status

string

The status of the ethereal. Possible values are: - active - unfunded (funds are below the level required for synchronisation.

balance

string

The balance of the ethereal contract.

sourceChain

string

The source chain for the contract being mirrored..

sourceContract

string

The source contract being mirrored.

tokenName

string

The name of the ethereal contract.

tokenSymbol

string

The symbol of the ethereal contract.

lastCheckedAt

Date

Unix date

lastSyncedAt

number

Unix timestamp of when this was last synced.

deposits

array

Array of objects detailing the ethereal's deposit history.

Example Request

GET https://api.bless.net/ethereals/1/0xe77c4e5e17ea350993cac2eb48bb50dbcccc956b

Response

{
    "ethereal": {
        "_id": "67c2fa24cf1e3ed713202e89",
        "ethereal": "0x61dcf30947a1d7f67a0b61dfcefc4e842724d66b",
        "status": "active",
        "balance": "1099756711100000000",
        "sourceChain": "1",
        "sourceContract": "0xe77c4e5e17ea350993cac2eb48bb50dbcccc956b",
        "tokenName": "Ethereal EtherTree",
        "tokenSymbol": "ETREE",
        "lastCheckTimestamp": 1740953590,
        "lastCheckDate": "2025-03-02T22:13:10.793Z",
        "lastSyncTimestamp": 1740953590,
        "lastSyncDate": "2025-03-02T22:13:10.793Z",
        "deposits": [
            {
                "timestamp": 1740831267,
                "depositor": "0xB95511Bfc49F2F90D3B828233AAb40aFA566fF62",
                "deposit": "1000000000000000"
            },
            {
                "timestamp": 1740943235,
                "depositor": "0x61bF58101f64b178d6433865B7EFA59c2A30ba9B",
                "deposit": "1100000000000000000"
            }
        ]
    }
}
Previous/etherealsNext/sprinkles

Last updated 1 month ago