tyche-solana-contract-upgrade

Governs building, deploying, and upgrading Tyche Solana programs through verified buffers and Squads proposals.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/IagoPrandi/ai-dealer --skill tyche-solana-contract-upgrade-iagoprandi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tyche-solana-contract-upgrade
Source: https://github.com/IagoPrandi/ai-dealer/tree/main/.claude/skills/tyche-solana-contract-upgrade
Command: npx skills add https://github.com/IagoPrandi/ai-dealer --skill tyche-solana-contract-upgrade-iagoprandi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an on-chain Solana program involves irreversible writes, upgrade authorities, ProgramData capacity, and multisig governance, where a single wrong artifact or unauthorized transaction can break a deployed program. This Skill enforces a strict, evidence-based release process so every contract change is built, verified, simulated, authorized, and governed before any network write occurs. ## Core Features & Use Cases - Release boundary classification: Distinguishes source-only changes, new deployments, upgradeable program changes, ProgramData extensions, and state migrations, each with its own required path. - Artifact and on-chain verification: Builds the exact SBF artifact with the pinned Docker toolchain, records SHA-256 and byte length, and independently reads program, ProgramData, buffer, and Squads multisig state before acting. - Governed upgrade workflow: Publishes upgrade buffers, hands buffer authority to the Squads vault, creates zero-approval proposals, and executes only after the on-chain threshold is met. - Use Case: A developer needs to upgrade the Tyche game program on devnet. The Skill builds the reviewed .so artifact, verifies ProgramData capacity, uploads and hash-verifies the buffer, creates a Squads proposal, and waits for member approvals before execution and post-upgrade readback. ## Quick Start Use the tyche-solana-contract-upgrade skill to prepare and govern an upgrade of the Tyche Solana program on devnet.

Frequently Asked Questions about tyche-solana-contract-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely upgrade a Solana program with a multisig?▼

Build the exact SBF artifact, upload it to a buffer, verify the on-chain SHA-256, transfer buffer authority to the Squads vault, then create a zero-approval proposal. Execute only after the on-chain approval threshold is met and the transaction matches the reviewed artifact.

How to extend ProgramData capacity before a Solana program upgrade?▼

Treat the ProgramData extension as its own governed action, separate from the upgrade. Execute the extension proposal first, re-read the final on-chain capacity, and only then upload or reuse the upgrade buffer.

Does this workflow support mainnet Solana deployments?▼

Yes, but mainnet requires a separate reviewed ceremony. Devnet members, vaults, identities, and artifacts are devnet-only and cannot be reused; every fact must be independently verified on the target cluster.

Why does my buffer hash not match the artifact SHA-256?▼

ProgramData and buffer payloads are zero-padded to their allocation, so you must hash exactly the first artifact byte length bytes. Trimming trailing zeros before hashing compares a different span and produces a mismatch.

Can I deploy a Solana program without explicit authorization using this skill?▼

No. The skill defaults to source-only changes and never deploys, uploads buffers, transfers authority, or creates Squads proposals without explicit user authorization for that exact action and cluster.