Skip to content

Latest commit

 

History

History
90 lines (63 loc) · 2.46 KB

README.md

File metadata and controls

90 lines (63 loc) · 2.46 KB

Punchcard

A native Solana program for tracking claimed indices using a bit vector.

image

Overview

Punchcard creates on-chain accounts that track N claimable slots using a compact bit representation. Each slot can only be claimed once by the designated authority. When all slots are claimed, the account is automatically closed and rent is returned.

Program ID

pcWKVSdcdDUKabPz4pVfaQ2jMod1kWv3LqeQivjKXiF

Instructions

Create

Creates a new punchcard account with the specified capacity.

Accounts:

Index Writable Signer Description
0 Yes Yes Payer (becomes authority)
1 Yes Yes Punchcard account
2 No No System program

Data:

Create { capacity: u64 }

Claim

Claims one or more indices on the punchcard. Only the authority can claim. Fails if any index is already claimed or out of bounds. Closes the account when all indices are claimed.

Accounts:

Index Writable Signer Description
0 Yes Yes Authority
1 Yes No Punchcard account

Data:

Claim { indices: Vec<u64> }

Account Structure

Field Size
authority 32 bytes
capacity 8 bytes
claimed 8 bytes
bits ceil(capacity / 8) bytes

Errors

Code Name Description
0 InvalidAuthority Signer does not match punchcard authority
1 IndexOutOfBounds Index >= capacity
2 AlreadyClaimed Index has already been claimed

Building

cargo build-sbf

Testing

cargo test-sbf

Dependencies

  • pinocchio - Lightweight Solana program framework
  • borsh - Instruction serialization
  • bytemuck - Safe zero-copy casting
  • litesvm - Integration testing (dev)

Verified Build

solana-verify verify-from-repo -b solanafoundation/solana-verifiable-build@sha256:ff3b148fb6adc3025c46ac38f132f473ccbdc4391f253234d98aa6519aec07f8 https://github.com/Ellipsis-Labs/punchcard --program-id pcWKVSdcdDUKabPz4pVfaQ2jMod1kWv3LqeQivjKXiF8