5 MINUTES TO FIRST MESSAGE

Get Started with Arcform

Activate a sovereign identity, send your first sealed envelope, and integrate webhooks — all in under 5 minutes. No wallet setup, no key management, no cryptographic complexity.

Step 1 — Activate Your Identity

One POST request creates a sovereign DID, generates an API key, and returns your cryptographic fingerprint. No wallet setup required.

curl -X POST https://api.arcform-api.com/v1/did/activate \
  -H "Content-Type: application/json" \
  -d '{ "label": "My First Identity" }'
bash

Response includes: api_key_id, DID, fingerprint, and plan details. Save your api_key_id — it's your identity handle for all subsequent calls.

Or create an account and generate keys from the dashboard.

Step 2 — Send a Sealed Envelope

Send an encrypted DIDComm envelope. Metadata is stripped, the payload is sealed end-to-end, and delivery is routed through mediator hops.

curl -X POST https://api.arcform-api.com/v1/channel/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-DID-API-Key: ak_YOUR_SENDER_KEY" \
  -d '{
    "to": "ak_RECIPIENT_KEY",
    "message": "Hello — this is a sealed envelope"
  }'
bash

Encryption

X25519-XSalsa20-Poly1305

Metadata

stripped_and_sealed

Routing

Multi-hop mediator

Step 3 — Register a Webhook

Arcform is webhook-first. Register an endpoint to receive sealed envelope deliveries in real time — no polling required.

curl -X POST https://api.arcform-api.com/v1/webhooks/register \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-DID-API-Key: ak_YOUR_KEY" \
  -d '{
    "url": "https://yourapp.com/webhooks/didcomms",
    "events": ["envelope.received"]
  }'
bash

Important: Save the whsec_ secret from the response. Use it to verify X-DIDComms-Signature headers on incoming webhook payloads.

Install the SDK

JavaScript / Node.js

npm install @didcomms/sdk
bash

Python

pip install didcomms-sdk
bash

Note: Until npm/pip packages are published, download the SDK source from the SDK Reference page.

Ready to build?

Free tier includes 1,000 messages/month. No credit card required.