REST API Specification

API Reference.

Interact programmatically with our indexing and metadata nodes. While the core protocol is EVM based, our secondary indexing layer exposes traditional REST endpoints for UI convenience.

Authentication & Host

All requests must be prefixed with the base URL:

https://api.digitalwill.protocol/api

You authenticate via an EIP-4361 standard JWT derived from your wallet signature. Pass this in the header:

Authorization: Bearer <YOUR_SIGNED_JWT>Content-Type: application/json

Endpoints

POST/v1/assets

Stable

Create a new encrypted asset reference. Associates the IPFS CID with the owner's wallet and defines release conditions.

GET/v1/assets/owner/:walletAddress

Stable

Retrieve all active asset configurations for a specific wallet address. Returns metadata, not the decryption keys.

POST/v1/heartbeat/ping

Stable

Record a liveness check-in for a specific wallet. Extends the decay timer before assets are released to beneficiaries.

POST/v1/beneficiaries/claim

Beta

Initiate an asset claim process. Requires proving identity and verifying the owner's vault has decayed.

Example Response

{
  "status": "success",
  "data": [
    {
      "assetId": "ast_f83h29",
      "type": "seed_phrase",
      "cid": "bafybeig..."
    }
  ]
}