Skip to content

Repository files navigation

ProofSetu Protocol

ProofSetu Protocol is an open-source verifiable workflow proof layer built on Stellar/Soroban.

Live Demo

Current MVP Flow

  1. Create a workflow proof record and SHA-256 document/event hash.
  2. Submit or anchor the proof through the Stellar/Soroban testnet integration.
  3. Retrieve the proof record from the deployed Soroban registry.
  4. Verify the stored hash against the expected value.
  5. Reject verification when the supplied hash does not match.
  6. Inspect the public verification result and transaction evidence.

The current v0.3 flow includes a deployed Stellar testnet Soroban contract and verified create_proof, get_proof, and verify_proof behavior. Local hashing remains part of the client workflow, while testnet anchoring provides the external verification layer.

Problem

Important real-world work often depends on scattered proof across WhatsApp, email, PDFs, screenshots, spreadsheets, and internal tools.

This creates disputes, delays, weak auditability, and lack of trust between parties.

Examples:

  • A freelancer says a milestone was completed.
  • A client says an invoice was approved or not approved.
  • An NGO wants to prove donation usage.
  • A startup wants to prove grant deliverables.
  • A hospital wants to prove that a claim document was submitted.
  • An AI-assisted workflow needs an accountable decision trail.

Solution

ProofSetu Protocol creates verifiable proof records for real-world workflow events.

Each proof record can include:

  • Proof ID
  • Proof type
  • Event title
  • Short description
  • Document or event hash
  • Timestamp
  • Creator wallet
  • Network reference
  • Verification status

The long-term goal is to anchor these proof records on Stellar/Soroban so anyone can verify that an event existed at a specific time without exposing private documents.

Why Stellar

Stellar provides fast, low-cost, open financial infrastructure suitable for real-world payment and trust workflows.

ProofSetu uses Stellar/Soroban to make workflow proof records verifiable, transparent, and ready to connect with future payment, milestone, invoice, escrow, remittance, or stablecoin settlement flows.

MVP Scope

The first version will include:

  • Landing page
  • Proof creation form
  • Hash generation
  • Local proof registry
  • Public verification page
  • Example proof records
  • Stellar testnet integration roadmap
  • Soroban proof registry contract roadmap

Use Cases

  1. Freelancer milestone proof
  2. NGO donation usage proof
  3. Startup grant deliverable proof
  4. Invoice approval proof
  5. Hospital document submission proof
  6. AI-assisted decision proof

Stellar Testnet Deployment

ProofSetu Protocol Phase 2 includes a deployed Soroban proof registry contract on Stellar testnet.

The contract has been built, tested locally, deployed to Stellar testnet, and invoked successfully.

Contract Details

  • Network: Stellar testnet
  • Contract ID: CD7VTK6VVMXCBWHOGPGWEHG3KFOLNSYMV3DNGK5BDMRWH74HGKLZRGGZ
  • Wasm hash: 743718b322e6dc81af3677bafadd236f4a85a76c87171a7847c582f25b400166
  • Deployer public address: GAT2L4GYPN2TST44AQA6QFVNWB4BUM7SXC73B4D5Y7PA4YRNHCLL

Deployment Transactions

  • Deployment transaction: 5ee448eb186c966fe6965fa7282b94d78a96df4e596dd9d0f6326cf3d0f6261b
  • Create proof transaction: 8a7fd049fcaf57e0c438a1b521b08cd30afe762cd6b74c172c302faccd98f132

Verified Testnet Flow

The deployed contract was tested successfully with a sample proof record.

  • create_proof returned true
  • get_proof returned the stored proof record
  • verify_proof with correct hash returned true
  • verify_proof with wrong hash returned false

Sample proof ID:

PS-TESTNET-001

Correct hash:

sample_testnet_hash_001

This confirms that ProofSetu Protocol can create, retrieve, and verify workflow proof records on Stellar testnet.

Documentation

Example Proof Records

Current Status

ProofSetu Protocol is currently in the repository setup and documentation stage.

Next planned step: prepare the v0.3.0 release with updated documentation, screenshots, and grant-readiness notes.

Roadmap

Completed

  • Repository setup
  • Documentation setup
  • Web MVP live on Vercel
  • Homepage
  • Create Proof page
  • Local SHA-256 proof hash generation
  • Generated proof record JSON output
  • Public sample verification page
  • Stellar testnet contract information page
  • Soroban proof registry contract scaffold
  • Local Soroban contract tests
  • Stellar testnet contract deployment
  • Initial testnet contract invocation
  • Frontend Stellar testnet config section
  • API scaffold for on-chain proof submission
  • Safe environment variable check API
  • Backend invocation security notes
  • Server-side Stellar configuration helper
  • Backend-assisted Stellar testnet proof submission
  • Real Stellar transaction hash returned to frontend
  • Create Proof UI updated for Stellar testnet submission
  • Dynamic on-chain proof verification API
  • Verify On-chain frontend page
  • Successful proof verification using proof ID and event hash
  • Negative verification test using wrong hash
  • Secret key stored server-side and not exposed
  • README screenshots updated for Stellar submission and verification

Current Milestone

Prepare ProofSetu Protocol v0.3.0 release.

This release should represent the first complete Stellar testnet MVP:

  • Create proof locally
  • Generate SHA-256 event hash
  • Submit proof to Stellar testnet
  • Return real transaction hash
  • Verify proof dynamically using proof ID and event hash
  • Display verified true/false result publicly
  • Keep secret keys server-side only

Next

  • Update PROJECT_STATUS.md
  • Update docs/GRANT_READINESS.md
  • Update docs/DEMO_WALKTHROUGH.md
  • Add final verification screenshot to README
  • Create v0.3.0 GitHub release
  • Prepare final grant-readiness summary
  • Prepare demo video script
  • Add final issue comments and close completed integration issue

Later

  • Public proof lookup by transaction hash
  • Better verification result styling
  • Wallet-based user flow
  • Database-backed proof history
  • Organization dashboard
  • File hash support
  • Grant deliverable workflow template
  • Invoice approval workflow template
  • NGO transparency dashboard
  • Hospital document submission workflow
  • AI decision proof trail
  • Mainnet readiness review

Screenshots

Homepage

Homepage

Create Proof Page

Create Proof Page

Generated Proof Hash

Generated Proof Hash

Sample Verification Page

Sample Verification Page

Stellar Testnet Contract Page

Stellar Testnet Contract Page

Create Proof Page with Stellar Config

Create Proof Page with Stellar Config

Create Proof On-chain Placeholder

Create Proof On-chain Placeholder

Verify Sample Page with Stellar Section

Verify Sample Page with Stellar Section

Create Proof API Scaffold Response

Create Proof API Scaffold Response

Create Proof Stellar Testnet Success

Create Proof Stellar Testnet Success

Verify On-chain Proof Success

Verify On-chain Proof Success

License

MIT

Demo Video

ProofSetu Protocol v0.3.0 demo video: https://youtu.be/7EKzgLwDhE0

Support continued development

If this project is useful to you, you can support Rama Chandra's independent technical work:

Support helps fund public development, AI and evaluation experiments, testing, documentation, hosting and maintenance.

Funding does not automatically grant private repository access, contributor permissions, consulting, custom development, confidential data access or exclusive IP rights.

About

Verifiable workflow proof layer on Stellar/Soroban.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages