Skip to content

README.md

Latest commit

 

History

History
116 lines (77 loc) · 2.93 KB

README.md

File metadata and controls

116 lines (77 loc) · 2.93 KB

Sports Goal Stake Vault

Custom Anchor vault program for a sports commitment product where a player stakes SOL against a goal.

If the goal is completed and verified, the player can reclaim the stake. If the goal fails, or a completed goal is not claimed within the claim window, the stake is routed to a pre-registered charity or franchise wallet. Settlement can happen only once.

Program

  • Program name: onchain
  • Devnet Program ID: 3HfJzm3qJawEJJhrFFn8aYSVYS8qT2B4s5JviAAyE6MB
  • Deploy signature: 2XpQWzn39dpmmMHmE5M36sZyD2Fb5qQgSuajzYnNc7yc3v493R1AMmFoiRb8gaBgBVXKvFBcwciQUVAS4RsbQ83T

Core Constraint Logic

This vault combines three constraints:

  1. Time-based restriction

    • A goal cannot be verified before deadline_ts.

  2. Condition-based release

    • Completed -> stake is refunded to the owner if claimed before verified_at + claim_window_secs.
    • Failed -> stake is sent to the registered recipient wallet.
    • Pending after deadline_ts + claim_window_secs -> the goal can be force-settled as failed and routed to the recipient wallet.

  3. One-time settlement

    • Once settled = true, no future settlement is allowed.

PDA Design

The program uses multiple PDAs:

  • config

    • Seeds: ["config"]
    • Stores admin and verifier authority.

  • recipient_registry

    • Seeds: ["recipient", recipient_wallet]
    • Stores approved charity or franchise recipients.

  • goal

    • Seeds: ["goal", owner, goal_id]
    • Stores goal state, deadline, stake, status, settlement state, and recipient mapping.

  • vault

    • Seeds: ["vault", goal]
    • Holds the lamports locked for the goal.

Instructions

  • initialize_platform

    • Initializes platform config and verifier authority.

  • register_recipient

    • Registers an allowed recipient wallet as either charity or franchise.

  • create_goal

    • Creates a goal account and vault PDA, then transfers the player's stake into the vault.

  • verify_goal

    • Verifier marks the goal as completed or failed after the deadline.

  • settle_goal

    • Moves the vault funds according to status and claim-window rules.

  • close_vault

    • Closes the vault account after settlement.

Tests

Passing test coverage:

  • refunds the owner for a completed goal
  • routes failed goal funds to the recipient and blocks double settlement
  • rotates the verifier and archives recipients after deactivation

Run:

anchor test

Latest passing output:

onchain
  ✔ refunds the owner for a completed goal
  ✔ routes failed goal funds to the recipient and blocks double settlement
  ✔ rotates the verifier and archives recipients after deactivation

3 passing

Passing test screenshot:

Passing Anchor tests

Build and Deploy

Build:

anchor build

Deploy to devnet:

solana config set --url devnet
anchor deploy --provider.cluster devnet

Files

  • Program: programs/onchain/src/lib.rs
  • Tests: tests/onchain.ts
  • Config: Anchor.toml