Skip to content

feat(backend): Implement IPFS metadata storage for escrow records #425

Description

@KuchiMercy

Description

IPFS module has controller/service stubs. Implement metadata hashing, IPFS pinning, and verification for tamper-proof records.

Module: src/modules/ipfs/

Acceptance Criteria

  • IpfsService: pinMetadata, getMetadata, verifyMetadata
  • Metadata schema: escrowId, buyer, seller, amount, asset, conditions, deadline, status, metadataHash
  • SHA-256 hash before pinning, store hash on escrow entity
  • Pin at lifecycle events: creation, funding, completion, dispute
  • ipfsCid and ipfsMetadataHash fields on Escrow entity
  • GET /escrows/:id/metadata, /metadata/verify
  • POST /escrows/:id/metadata/pin (admin only)
  • Configurable provider: local IPFS or Pinata (IPFS_PROVIDER env)
  • Graceful failure: retry once, log error, don't block
  • Metadata versioning (new CID per pin)
  • Unit and integration tests

Points: 200

Metadata

Metadata

Assignees

Labels

Stellar WaveIssues in the Stellar wave programbackendenhancementNew feature or requestipfsIPFS integrationphase-3Sprint 5-6: Enhanced UX & Security

Type

No type
No fields configured for issues without a type.

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions