EDGAR DAO Protocol

Event-Driven Governance, Accounting & Reporting — TrueSight DAO

Status
● Operational
Version
—
Network
Mainnet
REST API Endpoints
GET/pingHealth check
POST/dao/submit_contributionSubmit a signed contribution event
POST/dao/test/submit_contributionSandbox: test payload parsing (no signature)
GET/proxy/gas/*Proxy to Google Apps Script
GET/tracking/*Order tracking
POST/shipping/ratesShipping rate calculation
POST/stripe/order-syncStripe order sync
POST/stripe/subscriptionStripe subscription management
POST/subscription/obligationSubscription obligation check
GET/qr/check/{code}QR code lookup
GET/dao/transactionsQuery sales by partner, SKU, date range
GET/dao/qr-codesQuery QR codes by manager, owner, SKU, status
GET/dao/inventory-movementsQuery inventory transfers by person, role, date
DAO Query Endpoints

Read-only query endpoints for looking up DAO records. All name fields support case-insensitive substring matching.

Transactions

GET /dao/transactions — Sales records by partner, SKU, or date
▶
Parameters: partner (substring), sku (substring), from (YYYYMMDD), to (YYYYMMDD), limit (1–1000)
# Find all sales to SOHA curl "https://edgar.truesight.me/dao/transactions?partner=soha" # Response: { "results": [ { "date": "20260115", "partner": "SOHA", "sku": "ceremonial-cacao-fazenda-santa-ana-2023-200g", "qty": 10, "qr_code": "", "value": 0, "status": "", "source_sheet": "QR Code Sales", "source_row": 2 } ], "count": 1 }

QR Codes

GET /dao/qr-codes — QR codes by manager, owner, SKU, or status
▶
Parameters: manager (substring), owner (substring), sku (substring), status (exact: MINTED|SOLD|SAMPLE|GIFT), limit (1–1000)
# Find all QR codes managed by Kirsten curl "https://edgar.truesight.me/dao/qr-codes?manager=kirsten" # Response: { "results": [ { "qr_code": "2024OSCAR_20260121_12", "sku": "oscar-bahia-ceremonial-cacao-200g", "status": "MINTED", "manager": "Kirsten", "owner": "", "price": "25", "farm": "Oscar", "year": "2024", "ledger_name": "AGL#25", "source_sheet": "Agroverse QR codes", "source_row": 2 } ], "count": 1 }

Inventory Movements

GET /dao/inventory-movements — Inventory transfers by person, role, or date
▶
Parameters: person (substring), role (sender|recipient), from (YYYYMMDD), to (YYYYMMDD), limit (1–1000)
# Find all inventory movements involving David Campbell as recipient curl "https://edgar.truesight.me/dao/inventory-movements?person=campbell&role=recipient" # Response: { "results": [ { "date": "20260401", "sender": "Gary", "recipient": "David Campbell", "sku": "ceremonial-cacao-fazenda-santa-ana-2023-200g", "qty": 5, "ledger_name": "AGL#25", "status": "PROCESSED", "source_sheet": "Inventory Movement", "source_row": 4 } ], "count": 1 }
DAO Events Reference

Every DAO action is recorded as a signed event. Before submitting an event, check this reference to ensure you're using the correct type and format. Use lookup_event_docs("EVENT NAME") to fetch the docs for a specific event type.

[SALES EVENT] — Record a retail sale

When to use: A bag was sold to an end customer. Money changed hands. The QR code status will be updated to SOLD.
Not for: Moving bags between known holders in the supply chain (use [INVENTORY MOVEMENT] instead).
Required: Item (QR code), Sales price, Owner email  |  Optional: Sold by, Cash proceeds collected by, Stripe Session ID, Shipping Provider, Tracking number, Attached Filename, Submission Source
[SALES EVENT] - Item: 2024OSCAR_20260121_32 - Sales price: 17.50 - Sold by: Gergana - The Way Home Shop - Cash proceeds collected by: Gary Teh - Owner email: info@thewayhomeshop.com - Stripe Session ID: (none) - Shipping Provider: (none) - Tracking number: (none) - Attached Filename: None - Submission Source: https://dapp.truesight.me/report_sales.html

[INVENTORY MOVEMENT] — Record a transfer between holders

When to use: A bag moves between known holders in the supply chain (e.g. from warehouse to retailer, or retailer to another retailer).
Not for: End-customer sales (use [SALES EVENT] instead). If the recipient is a retail customer, it's a sale, not an inventory movement.
Required: Manager Name (sender), Recipient Name, Inventory Item (SKU), QR Code, Quantity
[INVENTORY MOVEMENT] - Manager Name: Kirsten - Recipient Name: Gergana - The Way Home Shop - Inventory Item: Ceremonial Cacao Kraft Pouch - Oscar 2024 - QR Code: 2024OSCAR_20260121_32 - Quantity: 1

[CONTRIBUTION EVENT] — Record a DAO contribution

When to use: A contributor spent time or money on DAO work. Earns TDG tokens.
Required: Title, Body, Contributors, Amount, Type (Time/USD)  |  Optional: PR URLs, TDG Issued
[CONTRIBUTION EVENT] - Title: Built query endpoints for Edgar - Body: Added /dao/transactions, /dao/qr-codes, /dao/inventory-movements - PR URLs: https://github.com/TrueSightDAO/dao_protocol/pull/116 - Contributors: Sophia Truesight - Amount: 120 - Type: Time (Minutes) - TDG Issued: 10

[REGISTER IDENTITY EVENT] — Register a new DAO identity

When to use: A new participant needs a DAO identity with an RSA keypair.
Required: Email, Public Key
[REGISTER IDENTITY EVENT] - Email: user@example.com - Public Key: -----BEGIN PUBLIC KEY----- MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...
DAO Events

Every DAO action is recorded as a signed event. Below is the complete catalog. Click any event to see its payload format, then Try in Sandbox to test it live.

Governance & Identity

[CONTRIBUTION EVENT] — Record a DAO contribution (time or USD)
report_contribution.html ▶
Attributes: Title, Body, PR URLs, Contributors, Amount, Type (Time/USD), TDG Issued
[CONTRIBUTION EVENT] - Title: Fixed QR code scanner bug - Body: Resolved edge case with batch scanning - PR URLs: https://github.com/TrueSightDAO/truesight_autopilot/pull/42 - Contributors: Sophia Truesight - Amount: 120 - Type: Time (Minutes) - TDG Issued: 10
[REGISTER IDENTITY EVENT] — Register a new DAO identity
register_identity.html ▶
Attributes: Email, Public Key
[REGISTER IDENTITY EVENT] - Email: user@example.com - Public Key: -----BEGIN PUBLIC KEY----- MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...
[SALES EVENT] — Record a retail sale
▶
Attributes: Item (QR code), Sales price, Sold by, Cash proceeds collected by, Owner email (required), Stripe Session ID, Shipping Provider, Tracking number, Attached Filename, Submission Source
[SALES EVENT] - Item: 2024OSCAR_20260121_32 - Sales price: 17.50 - Sold by: Gergana - The Way Home Shop - Cash proceeds collected by: Gary Teh - Owner email: info@thewayhomeshop.com - Stripe Session ID: (none) - Shipping Provider: (none) - Tracking number: (none) - Attached Filename: None - Submission Source: https://dapp.truesight.me/report_sales.html
[INVENTORY MOVEMENT] — Record a transfer between holders
▶
Attributes: Manager Name (sender), Recipient Name, Inventory Item (SKU), QR Code, Quantity
[INVENTORY MOVEMENT] - Manager Name: Kirsten - Recipient Name: Gergana - The Way Home Shop - Inventory Item: Ceremonial Cacao Kraft Pouch - Oscar 2024 - QR Code: 2024OSCAR_20260121_32 - Quantity: 1
Ecosystem
TrueSight DAO DApp Agroverse Shop GitHub