Skip to content

Comments

feat: add service, escrow, and L402 credential schemas#3

Open
hexdaemon wants to merge 1 commit intoarchetech:mainfrom
hexdaemon:add-service-escrow-l402-schemas
Open

feat: add service, escrow, and L402 credential schemas#3
hexdaemon wants to merge 1 commit intoarchetech:mainfrom
hexdaemon:add-service-escrow-l402-schemas

Conversation

@hexdaemon
Copy link
Contributor

Summary

Three new credential schema sets extending the Archon identity ecosystem with service delegation, task escrow, and L402 payment access.

New Schemas

credentials/service/v1/

  • DIDServiceCredential — Scoped delegation with permissions, constraints, tiers, and compensation terms. General-purpose: any DID can delegate specific capabilities to another DID with enforced boundaries.
  • DIDServiceProfile — Service advertising credential for marketplace discovery. Capabilities, pricing models, availability, specialization, and reputation references.

credentials/escrow/v1/

  • DIDTaskEscrowReceipt — Signed proof-of-completion for conditional Cashu ecash escrow (NUT-10/11/14). Binds task execution to payment release. The verifier (oracle) signs the receipt when work is verified, enabling the executor to redeem their escrowed payment.

credentials/l402/v1/

Design Documents

These schemas are extracted from a comprehensive protocol suite for trustless agent service markets:

  1. DID-L402-FLEET-MANAGEMENT — Architecture, task taxonomy, danger scoring
  2. DID-REPUTATION-SCHEMA — General-purpose verifiable reputation (already merged as credentials/reputation/v1)
  3. DID-CASHU-TASK-ESCROW — Conditional ecash escrow protocol
  4. DID-HIVE-SETTLEMENTS — Trustless multi-operator fleet economics
  5. DID-HIVE-MARKETPLACE — Service advertising, discovery, and contracting

Conventions

All schemas follow the patterns established by credentials/reputation/v1:

  • JSON Schema draft-07
  • W3C VC 2.0 compliant (validFrom/validUntil, v2 context)
  • schemas.archetech.com/credentials/<type>/v1 context URLs
  • Every field has a description
  • Patterns/enums for validation where appropriate

Relationship to archetech/archon#75

The L402AccessCredential directly addresses the L402 feature request. It defines the credential structure for DID-bound macaroons backed by Lightning invoices and/or Cashu tokens.

Three new credential schema sets for the Archon ecosystem:

Service (credentials/service/v1/):
- DIDServiceCredential: Scoped delegation with permissions, constraints,
  tiers, and compensation terms. General-purpose service authorization.
- DIDServiceProfile: Service advertising credential for marketplace
  discovery. Capabilities, pricing, availability, reputation references.

Escrow (credentials/escrow/v1/):
- DIDTaskEscrowReceipt: Signed proof-of-completion for conditional
  Cashu ecash escrow. Binds task execution to payment release.

L402 (credentials/l402/v1/):
- L402AccessCredential: DID-bound L402 access with payment proof and
  macaroon caveats. Addresses archetech/archon#75.

All schemas follow the conventions established by credentials/reputation/v1:
JSON Schema draft-07, W3C VC 2.0 compliant, archetech.com context URLs.

Design documents: github.com/lightning-goats/cl-hive/tree/main/docs/planning
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant