Skip to content

Repository files navigation

protocol-core

Solana programs for the Entros Protocol. Three Anchor programs handle Anchor minting, zero-knowledge verification, and protocol configuration.

Programs

entros-anchor creates a non-transferable Token-2022 credential. It stores verification history and Trust Score in one wallet-derived IdentityState PDA.

Minting requires a validator-signed Ed25519 receipt. The receipt binds the wallet, commitment, and validation timestamp.

entros-verifier verifies Groth16 proofs and public inputs through groth16-solana. It also manages anti-replay challenge nonces.

entros-registry stores protocol configuration and validator-registration scaffolding. The devnet program accepts SOL deposits but does not select validators or distribute rewards.

Devnet Program IDs

Program ID
entros-registry 6VBs3zr9KrfFPGd6j7aGBPQWwZa5tajVfA7HN6MMV9VW
entros-verifier 4F97jNoxQzT2qRbkWpW3ztC3Nz2TtKj3rnKG8ExgnrfV
entros-anchor GZYwTp2ozeuRA5Gof9vs4ya961aANcJBdUzB7LN6q4b2

Setup

# Prerequisites: Rust 1.91.0, Solana CLI 3.1.10, Anchor CLI 1.1.2, Node.js 24.15.0

# Install dependencies
npm ci

# Build all programs
anchor build

# Run the isolated Anchor integration suite
npm run test:localnet

# Run all LiteSVM suites
npm run test:litesvm

# Upgrade all three devnet programs with the registered admin authority
sh scripts/upgrade-devnet.sh

Tests

cargo fmt --all -- --check
cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
cargo test --workspace --all-features --locked
anchor build --no-idl -- -- --locked
anchor build
npm run typecheck
npm run test:localnet
npm run test:litesvm

The integration suite covers:

  • Identity minting (NonTransferable Token-2022, duplicate prevention, multi-user)
  • Proof verification (valid/invalid proofs, challenge expiry, replay prevention)
  • Registry (protocol initialization, validator registration scaffolding, Trust Score preview)
  • End-to-end mint, challenge, proof, and Trust Score updates

Separate LiteSVM suites cover transfer restrictions, account migration, Trust Score rules, and compute behavior.

License

MIT

About

Solana programs for Entros Anchor state, ZK proof verification, Trust Score updates, and protocol configuration.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages