Multisig Wallet

A secure, decentralized multisignature wallet implementation on Solana blockchain built with the Anchor framework. This project enables multiple signers to collectively manage funds through a quorum-based approval system.

🚀 Features

Multi-signature Support: Configure multiple signers with customizable quorum thresholds
Transaction Proposals: Any signer can propose transactions for approval
Quorum-based Execution: Transactions execute only when sufficient signatures are collected
Program Derived Addresses (PDAs): Deterministic account generation for security
Comprehensive Error Handling: Robust validation and error management
TypeScript Integration: Full TypeScript support with Anchor framework
Test Coverage: Comprehensive test suite for all functionality

🏗️ Architecture

Core Components

Wallet Account: Stores signers, quorum threshold, and transaction counter
Transaction Account: Tracks individual transaction proposals and approvals
Four Main Instructions:
- initialize_wallet: Set up the multisig wallet
- propose_transaction: Create transaction proposals
- approve_transaction: Collect signer approvals
- execute_transaction: Execute approved transactions

graph TB
    %% Client Layer
    subgraph "Client Layer"
        Client[Client Application]
        TestSuite[Test Suite<br/>TypeScript]
        Provider[Anchor Provider]
    end

    %% Solana Network
    subgraph "Solana Network"
        RPC[RPC Endpoint]
        Validators[Solana Validators]
    end

    %% Program Layer
    subgraph "Multisig Wallet Program"
        ProgramID[Program ID:<br/>BVp4CE4SE5hcLFg8ybWSYak1xdHUGTpYTGYcmEoFhAx1]
        
        subgraph "Core Instructions"
            InitWallet[Initialize Wallet]
            ProposeTx[Propose Transaction]
            ApproveTx[Approve Transaction]
            ExecuteTx[Execute Transaction]
        end
        
        subgraph "Data Structures"
            WalletAccount[Wallet Account<br/>- signers: Vec&lt;Pubkey&gt;<br/>- quorum: u8<br/>- tx_counter: u64]
            TransactionAccount[Transaction Account<br/>- to: Pubkey<br/>- lamports: u64<br/>- signed: Vec&lt;Pubkey&gt;<br/>- wallet: Pubkey]
        end
        
        subgraph "Error Handling"
            Errors[MultisigError Enum<br/>- TooManySigners<br/>- InvalidQuorum<br/>- NotSigner<br/>- AlreadyApproved<br/>- AlreadyExecuted<br/>- NotEnoughSigners<br/>- WrongWallet<br/>- NotEnoughLamports<br/>- InvalidReceiver<br/>- InvalidProposer]
        end
    end

    %% Account Management
    subgraph "Account Management"
        PDAs[Program Derived Addresses]
        Seeds[Seeds:<br/>- wallet: hashsigners<br/>- transaction: wallet + counter]
        Constraints[Account Constraints<br/>- Signer validation<br/>- Quorum checks<br/>- Lamport validation]
    end

    %% External Systems
    subgraph "External Systems"
        SystemProgram[Solana System Program]
        Keypairs[User Keypairs<br/>- Signers<br/>- Proposers<br/>- Recipients]
    end

    %% Workflow
    subgraph "Transaction Workflow"
        Step1[1. Initialize Wallet<br/>Set signers & quorum]
        Step2[2. Propose Transaction<br/>Create transaction proposal]
        Step3[3. Approve Transaction<br/>Collect signatures]
        Step4[4. Execute Transaction<br/>Transfer lamports]
    end

    %% Connections
    Client --> Provider
    Provider --> RPC
    RPC --> Validators
    Validators --> ProgramID
    
    ProgramID --> InitWallet
    ProgramID --> ProposeTx
    ProgramID --> ApproveTx
    ProgramID --> ExecuteTx
    
    InitWallet --> WalletAccount
    ProposeTx --> TransactionAccount
    ApproveTx --> TransactionAccount
    ExecuteTx --> TransactionAccount
    
    WalletAccount --> PDAs
    TransactionAccount --> PDAs
    PDAs --> Seeds
    PDAs --> Constraints
    
    InitWallet --> Errors
    ProposeTx --> Errors
    ApproveTx --> Errors
    ExecuteTx --> Errors
    
    ExecuteTx --> SystemProgram
    SystemProgram --> Keypairs
    
    Step1 --> Step2
    Step2 --> Step3
    Step3 --> Step4
    
    TestSuite --> Client
    TestSuite --> Provider

    %% Styling
    classDef programClass fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    classDef accountClass fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
    classDef clientClass fill:#e8f5e8,stroke:#1b5e20,stroke-width:2px
    classDef workflowClass fill:#fff3e0,stroke:#e65100,stroke-width:2px
    
    class ProgramID,InitWallet,ProposeTx,ApproveTx,ExecuteTx programClass
    class WalletAccount,TransactionAccount,PDAs accountClass
    class Client,TestSuite,Provider clientClass
    class Step1,Step2,Step3,Step4 workflowClass

Program ID

BVp4CE4SE5hcLFg8ybWSYak1xdHUGTpYTGYcmEoFhAx1

📋 Prerequisites

Rust (latest stable version)
Solana CLI (v1.17.0 or later)
Anchor Framework (v0.31.1 or later)
Node.js (v16 or later)
Yarn package manager

🛠️ Installation

Clone the repository

git clone <repository-url>
cd multisig-wallet

Install dependencies
```
yarn install
```
Build the program
```
anchor build
```
Run tests
```
anchor test
```

🚀 Quick Start

1. Initialize a Multisig Wallet

import * as anchor from "@coral-xyz/anchor";
import { Program } from "@coral-xyz/anchor";

// Create signers
const signers = [
  web3.Keypair.generate(),
  web3.Keypair.generate(),
  web3.Keypair.generate()
];

const signersPubkeys = signers.map(s => s.publicKey);

// Initialize wallet with 2-of-3 quorum
await program.methods.initializeWallet(
  signersPubkeys,
  2  // quorum threshold
).accounts({
  wallet: walletPDA,
  payer: provider.wallet.publicKey
}).rpc();

2. Propose a Transaction

// Any signer can propose a transaction
await program.methods.proposeTransaction(
  recipientPubkey,
  new anchor.BN(amountInLamports)
).accounts({
  wallet: walletPDA,
  proposer: signersPubkeys[0]
}).signers([signers[0]]).rpc();

3. Approve Transactions

// Signers approve the transaction
await program.methods.approveTransaction().accounts({
  transaction: transactionPDA,
  signer: signersPubkeys[0]
}).signers([signers[0]]).rpc();

await program.methods.approveTransaction().accounts({
  transaction: transactionPDA,
  signer: signersPubkeys[1]
}).signers([signers[1]]).rpc();

4. Execute Transaction

// Execute when quorum is reached
await program.methods.executeTransaction().accounts({
  to: recipientPubkey,
  transaction: transactionPDA,
  signer: signersPubkeys[0]
}).signers([signers[0]]).rpc();

📚 API Reference

Instructions

`initialize_wallet(signers: Vec<Pubkey>, quorum: u8)`

Initializes a new multisig wallet with specified signers and quorum threshold.

Parameters:

signers: Array of public keys authorized to sign transactions
quorum: Minimum number of signatures required to execute transactions

Constraints:

quorum > 0
signers.length <= 20 (MAX_SIGNERS)
signers.length >= quorum

`propose_transaction(to: Pubkey, lamports: u64)`

Creates a new transaction proposal.

Parameters:

to: Recipient public key
lamports: Amount to transfer in lamports

Constraints:

Proposer must be one of the wallet signers

`approve_transaction()`

Approves a pending transaction.

Constraints:

Signer must be authorized wallet signer
Signer must not have already approved
Transaction must not be executed

`execute_transaction()`

Executes an approved transaction.

Constraints:

Sufficient signatures collected (quorum met)
Wallet has sufficient lamports
Transaction not already executed

Data Structures

Wallet Account

pub struct Wallet {
    pub signers: Vec<Pubkey>,    // Authorized signers
    pub quorum: u8,              // Required signatures
    pub tx_counter: u64,         // Transaction counter
}

Transaction Account

pub struct Transaction {
    pub to: Pubkey,              // Recipient
    pub lamports: u64,          // Amount
    pub signed: Vec<Pubkey>,    // Approved signers
    pub wallet: Pubkey,         // Parent wallet
}

Error Types

Error	Description
`TooManySigners`	Exceeds maximum signer limit (20)
`InvalidQuorum`	Quorum must be greater than 0
`NotSigner`	Signer not authorized for wallet
`AlreadyApproved`	Signer already approved transaction
`AlreadyExecuted`	Transaction already executed
`NotEnoughSigners`	Insufficient signers for quorum
`WrongWallet`	Transaction doesn't belong to wallet
`NotEnoughLamports`	Insufficient funds in wallet
`InvalidReceiver`	Invalid recipient address
`InvalidProposer`	Proposer not authorized

🧪 Testing

The project includes comprehensive tests covering:

Wallet initialization with various configurations
Transaction proposal and approval workflows
Error handling and edge cases
Quorum validation
Security constraints

Run tests with:

anchor test

🔒 Security Considerations

Quorum Configuration: Choose quorum carefully - too low compromises security, too high may cause deadlocks
Signer Management: Only add trusted signers to the wallet
Transaction Review: Always review transaction details before approval
Key Management: Secure storage of signer private keys is critical
Network Security: Use secure RPC endpoints in production

🚀 Deployment

Local Development

# Start local validator
solana-test-validator

# Deploy to localnet
anchor deploy

Mainnet Deployment

# Build for production
anchor build --release

# Deploy to mainnet
anchor deploy --provider.cluster mainnet-beta

📁 Project Structure

multisig-wallet/
├── programs/
│   └── multisig-wallet/
│       └── src/
│           ├── lib.rs                 # Main program entry point
│           ├── account.rs             # Account structures
│           ├── constants.rs           # Program constants
│           ├── errors.rs              # Error definitions
│           └── instructions/          # Instruction implementations
│               ├── initialize_wallet.rs
│               ├── propose_transaction.rs
│               ├── approve_transaction.rs
│               └── execute_transaction.rs
├── tests/
│   └── multisig-wallet.test.ts        # Test suite
├── Anchor.toml                        # Anchor configuration
├── Cargo.toml                         # Rust dependencies
└── package.json                       # Node.js dependencies

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
migrations		migrations
programs/multisig-wallet		programs/multisig-wallet
tests		tests
.gitignore		.gitignore
.prettierignore		.prettierignore
Anchor.toml		Anchor.toml
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
README.md		README.md
package.json		package.json
tsconfig.json		tsconfig.json
yarn.lock		yarn.lock

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Multisig Wallet

🚀 Features

🏗️ Architecture

Core Components

Program ID

📋 Prerequisites

🛠️ Installation

🚀 Quick Start

1. Initialize a Multisig Wallet

2. Propose a Transaction

3. Approve Transactions

4. Execute Transaction

📚 API Reference

Instructions

`initialize_wallet(signers: Vec<Pubkey>, quorum: u8)`

`propose_transaction(to: Pubkey, lamports: u64)`

`approve_transaction()`

`execute_transaction()`

Data Structures

Wallet Account

Transaction Account

Error Types

🧪 Testing

🔒 Security Considerations

🚀 Deployment

Local Development

Mainnet Deployment

📁 Project Structure

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Multisig Wallet

🚀 Features

🏗️ Architecture

Core Components

Program ID

📋 Prerequisites

🛠️ Installation

🚀 Quick Start

1. Initialize a Multisig Wallet

2. Propose a Transaction

3. Approve Transactions

4. Execute Transaction

📚 API Reference

Instructions

initialize_wallet(signers: Vec<Pubkey>, quorum: u8)

propose_transaction(to: Pubkey, lamports: u64)

approve_transaction()

execute_transaction()

Data Structures

Wallet Account

Transaction Account

Error Types

🧪 Testing

🔒 Security Considerations

🚀 Deployment

Local Development

Mainnet Deployment

📁 Project Structure

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`initialize_wallet(signers: Vec<Pubkey>, quorum: u8)`

`propose_transaction(to: Pubkey, lamports: u64)`

`approve_transaction()`

`execute_transaction()`

Packages