Donor Agent Protocol (DAP) v0.1

An Evidence-First Donation Layer

The Donor Agent Protocol (DAP) is a simple, evidence-first donation layer built on modern web standards. It reuses proven payment protocol models without unnecessary complexity, providing auditable, non-repudiable evidence for every donation while keeping the user experience simple.

Focus of v0.1: A minimal, verifiable foundation for one-time and recurring donations using Verifiable Credentials. No new on-chain assets, mandatory attestations, or complex tax encodings.

The Three Core Objects

DAP is built on exactly three Verifiable Credentials (VCs). These are JSON objects with a cryptographic proof, creating a secure and verifiable chain of evidence for every transaction.

How It Works: The Donation Flow

The interaction between the donor, platform, and recipient is simple and secure. Each step generates a piece of verifiable evidence.

Quick Start

💬 Try it in Slack (No Code Required)

The fastest way to experience DAP is through our Slack bot. Simply invite the bot to your workspace and start creating cryptographically-signed donation credentials:

# In any Slack channel:
/donate 50 pseudonymous campaign-1

# Get help:
/donate help

# See available campaigns:
/donate list

What you get: The bot instantly generates and displays three verifiable credentials (DIM, DPM, VP) right in Slack. Perfect for demos, testing, or learning how DAP works without writing any code.

💻 Developer Integration

Integrating with DAP is straightforward using the TypeScript SDK. Create and sign mandates with just a few lines of code.

import { DonorAgent, InMemoryVault, Mandates, Validators } from "@gfm/donor-protocol-sdk";

const agent = new DonorAgent({ did: "did:key:zDonorKey", storage: new InMemoryVault() });

// 1. Build and sign the Donor's Intent (DIM)
const dimDraft = Mandates.createDonationIntent({
  recipientDid: "did:org:charity-123",
  amount: { value: 50, currency: "USD" },
  privacy: "anonymous_to_organizer",
  restricted: true,
  ttl: new Date(Date.now() + 1000*60*60*24*30).toISOString(),
  mode: "HUMAN_PRESENT"
});
Validators.assertDIM(dimDraft);
const dim = await agent.signIntent(dimDraft);

// 2. Build and sign the Payment Mandate (DPM)
const dpmDraft = agent.buildPaymentMandate({ intent: dim, paymentMethod: "card" });
Validators.assertDPM(dpmDraft);
const dpm = await agent.signPaymentMandate(dpmDraft);

// 3. Present VCs to the platform
const vp = await agent.present({ audienceDid: "did:web:oa.gfm.org", vcs: [dim, dpm] });

Try DAP in Slack

Experience the Donation Agent Protocol without writing code. Our Slack bot lets you create real, cryptographically-signed credentials with simple commands.

Quick Commands

Example Output

When you run /donate 50 pseudonymous campaign-1, you get three cryptographically-signed credentials:

Getting Started

1. Deploy the bot - Follow the deployment guide in the donor-agent-slackbot/ folder
2. Invite to channel - Add the bot to your Slack workspace
3. Type /donate help - See the complete interactive guide
4. Make your first donation - Try /donate 10 pseudonymous campaign-1

💡 Pro Tip: The Slack bot is perfect for demos, workshops, or testing integrations. All credentials are real and follow the DAP v0.1 spec exactly—they're just not connected to actual payment processors.

Frequently Asked Questions

Liability & Disputes