/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" ] } '

200

{
    "message": "sprinkles requested",
    "requestOwner": "airdrop",
    "key": "zy/hKhyIn2JC7ueDMRXQCP2lFgBQzs1U4Fhxn15s9nU=",
    "for": "0x66f13e0bd1Cc72FF147Fc3F5ab7baC036edEbae8",
    "destinationChain": 45513,
    "deliveryId": "45513/0xcf2fe12a1c889f6242eee7833115d008fda5160050cecd54e058719f5e6cf675/0x66f13e0bd1Cc72FF147Fc3F5ab7baC036edEbae8/1726807020",
}

400

{
    "message": "chainId is required"
}

{
    "message": "receivers is required"
}