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
  • Params
  • requestBody
  • Response Body
  • Example Request
  1. Blessnet API

/sprinkles

You need an API key for this call. Your API key must have aidrops enabled. Please reach out to the Blessnet team for more details.

POST /sprinkles

The /sprinkles endpoint allows you to airdrop a small balance of BLESS to recipient addresses.

This endpoint provides permissioned access to the BLESS Sprinkler contract. This contract will distribute a small BLESS balance to the addresses provided, subject to a maximum amount by request origin and recipient address.

Headers

Name
Value

x-api-key

Your API key

Params

Name
Value

chain

The chain. Possible values: mainnet Send to mainnet Blessnet (45513) sepolia Send to sepolia Blessnet (11145513)

requestBody

  • required: true

  • content: application/json:

  • schema:

    • type: array

    • items: type: string pattern: "^0x[a-fA-F0-9]{40}$"

  • description: A list of valid EVM addresses in hexadecimal format (0x-prefixed, 40 hexadecimal characters).

example:

{
  "receivers": [
    "0x66f13e0bd1Cc72FF147Fc3F5ab7baC036edEbae8",
    "0x69c368F76DEB816c9DA037ff562cFA76eA31820e",
    "0xb6e225e990794743ED4Cd19F1639b88d39358b30"
  ]
}

Response Body

Name
Type
Description

message

string

"Airdrop Requested"

requestOwner

string

The owner of the API key making the request

key

string

The base64 API key

for

string

The recipient of the airdrop

deestinationChain

string

The target chain

delvieryId

string

Unique ID

Example Request

curl --location 'https://api.bless.net/sprinkles?chainId=11145513'
--header 'x-api-key: <key>'
--header 'Content-Type: application/json'
--data '{ "receivers": [ "0x66f13e0bd1Cc72FF147Fc3F5ab7baC036edEbae8", "0x69c368F76DEB816c9DA037ff562cFA76eA31820e", "0xb6e225e990794743ED4Cd19F1639b88d39358b30" ] } '
{
    "message": "sprinkles requested",
    "requestOwner": "airdrop",
    "key": "zy/hKhyIn2JC7ueDMRXQCP2lFgBQzs1U4Fhxn15s9nU=",
    "for": "0x66f13e0bd1Cc72FF147Fc3F5ab7baC036edEbae8",
    "destinationChain": 45513,
    "deliveryId": "45513/0xcf2fe12a1c889f6242eee7833115d008fda5160050cecd54e058719f5e6cf675/0x66f13e0bd1Cc72FF147Fc3F5ab7baC036edEbae8/1726807020",
}
{
    "message": "chainId is required"
}

{
    "message": "receivers is required"
}
Previous/ethereals/:chainId/:addressNext/tokens/:address/:id/uri

Last updated 2 months ago