Stable Release v1.0.0

The Sum of
Secure Finance

SIGMA Protocol is a modular, weighted-equity multisig framework built for Botchain, designed for decentralized corporate governance. It replaces the standard 1-person-1-vote model with voting power based on actual ownership percentages.

Quick Start Guide

1

Define Owners

Gather the wallet addresses of your board members. Decide on their equity percentage (e.g., CEO: 40%, CTO: 30%, Investor: 30%).

2

Set Thresholds

Choose a Required Percentage (e.g., 51%). This means funds can only move if owners holding at least 51% of equity sign the transaction.

3

Deploy Treasury

Click "Create Treasury". This deploys two contracts: your Governance Controller and your Asset Vault. The Creator Address cannot be part of the initial signers.

Modular Architecture

MultiSigFactoryREGISTRY

Deploys isolated Controller/Wallet pairs for every new treasury on Botchain.

MultiSigControllerGOVERNANCE

The Brain. Handles confirmation logic, voting weights, and timelocks.

CompanyWalletVAULT

The immutable asset holder. Only executes calls authorized by its Controller.

Weighted Governance

Approval is based on the Sum of Equity. A transaction passes only when the combined voting weight (%) of signers meets the requiredPercentage.

// EXAMPLE: REQUIRED THRESHOLD 51%
Owner A (CEO)40% [SIGNED]
Owner B (CFO)20% [SIGNED]
Total Weight60% (PASSED)

Supported Assets

Botchain Native Gas

Full native support for Botchain's gas token across every treasury deployed on the network.

Botchain Native Token

ERC-20 Tokens

Compatible with any ERC-20 token deployed on Botchain.

USDC (Botchain)WETH (Botchain)

ERC-20 Tokens

Compatible with all standard ERC-20 tokens, dynamically mapped to your active network connection.

USDCUSDTUSDmWETH

DeFi Integrations

Sigma Protocol supports advanced execution via raw calldata, allowing your treasury to interact directly with decentralized exchanges (DEXes) deployed on Botchain, directly from the dashboard.

Automated Token Swaps

  • Dynamic Routing: Select your network, and Sigma will automatically provide the canonical routers for that chain.
  • Calldata Generation: Input your token pairs, and the dashboard auto-generates the encoded swapExactTokensForTokens call.
  • Important: You must submit a standard ERC-20 Approve transaction before executing a swap if the DEX contract is not yet authorized to spend your treasury's tokens.

Batch Operations

Sigma allows for high-volume transactions via CSV upload. Ideal for payroll, investor distributions, or mass airdrops.

CSV Format

address,amount
0x8740...16e8, 10.5
0x10c6...fF78, 5.0
0x4200...0006, 22.1

Download Template

Get the standard .CSV format for mass payouts

Security Guardrails

Security Best Practices

  • Always verify the Contract Address before sending funds.
  • Rotate owners immediately if a private key is suspected compromised.
  • Use a Timelock of at least 24 hours for treasuries holding significant value.
  • In case of suspicious activity, the Creator can Pause the Contract.

Execution Timelock

Mandatory delay period after approval. Allows owners to review or revoke high-value transfers before they execute.

Proposal Expiry

Stale proposals are automatically invalidated after the expiry period, keeping the treasury queue secure.

Contract Addresses

Sigma Protocol is deployed on Botchain. Every treasury you create gets its own unique Controller and Vault contract address, registered under the single MultiSigFactory below.

Contract ComponentAddress (Botchain)
MultiSigFactory0x204C4913b83899b91DdF61A0b2BFaeef25c2bCBb
Your ControllerUnique per treasury — see your dashboard
Your VaultUnique per treasury — see your dashboard

Developer API

Ethers.js v6 Implementation
// 1. Calculate gas with a 20% buffer for batch/swap calls
                const estimate = await contract.execute.estimateGas(txId);
                const gasLimit = (estimate * 120n) / 100n;

                // 2. Execute on-chain transaction
                await contract.executeTransactionManual(txId, { gasLimit });

Troubleshooting

Error: "Execution Failed"

Common causes:
Insufficient Funds: The CompanyWallet lacks native gas tokens or the specific ERC-20 tokens.
Reentrancy Guard: The transaction logic is locked by a nonReentrant modifier.
Missing Allowance: You attempted a DeFi swap without approving the Router contract first.

Error: "Gas Estimation Failed"

This usually means the transaction will revert. Check if the Timelock Period has passed, if the proposal has already expired, or if the target network is heavily congested.