How ship-armada/armada-poc works
Armada combines near-term crowdfund and governance applications with a local cross-chain privacy-pool and shielded-yield demo. Participants use the crowdfund app to commit and claim; governance users inspect and manage proposals and treasury state. In the demo, users shield, privately transfer, unshield, or use yield, while the relayer supports cross-chain operations. The repository tree omits the Solidity contracts, and several key flows are documented but their implementation was not sampled; dashed edges mark those unverified connections.
Main entry points: App.tsx Governance App · index.ts Privacy SDK · armada-relayer.ts Armada Relayer · server.ts MCP Server
Components 27
Crowdfund
- Committer App
crowdfund-ui/packages/committer/src/App.tsx - Commit Pipeline
crowdfund-ui/packages/committer/src/hooks/useTxPipeline.ts - Admin App
crowdfund-ui/packages/admin/src/App.tsx - Crowdfund Indexer
crowdfund-ui/packages/indexer/src/api/server.ts
Governance
- Governance App
governance-ui/src/App.tsx - Wallet Access
governance-ui/src/hooks/useWallet.ts - Contract Access
governance-ui/src/hooks/useGovernanceContracts.ts - Governance Data
governance-ui/src/hooks/useGovernanceData.ts - Proposal Actions
governance-ui/src/components/ProposalsPanel.tsx - Proposal Form
governance-ui/src/components/CreateProposalForm.tsx - Treasury Controls
governance-ui/src/components/TreasuryPanel.tsx - Wind-down Controls
governance-ui/src/components/WindDownPanel.tsx
Privacy Demo
- Privacy SDK
lib/sdk/index.ts - SDK Wallet
lib/sdk/wallet.ts - Shield Operations
lib/sdk/shield.ts - Network Scanning
lib/sdk/network.ts - Proof Builder
lib/sdk/prover.ts - Transfer Operations
lib/sdk/transfer.ts - Shielded Yield
Operations
- Armada Relayer
relayer/armada-relayer.ts - Relayer Wallet
relayer/modules/wallet-manager.ts - Chain Configuration
config/networks.ts - MCP Server
mcp-server/src/server.ts - Contract Queries
mcp-server/src/tools/contract-state.ts
Other components
- Participant
- Governance User
- Demo User
Connections 24
- Participant → Committer App: uses
README.md - Committer App → Commit Pipeline: runs pipeline
- Participant → Admin App: administers sale
README.md - Governance User → Governance App: uses
README.md - Governance App → Wallet Access: connects wallet
governance-ui/src/App.tsx - Governance App → Contract Access: loads contracts
governance-ui/src/App.tsx - Governance App → Governance Data: loads data
governance-ui/src/App.tsx - Governance Data → Contract Access: reads contracts
governance-ui/src/hooks/useGovernanceData.ts - Governance App → Proposal Actions: renders
governance-ui/src/App.tsx - Governance App → Treasury Controls: renders
governance-ui/src/App.tsx - Proposal Actions → Proposal Form: renders
governance-ui/src/components/ProposalsPanel.tsx - Governance App → Wind-down Controls: renders
- Demo User → Privacy SDK: requests privacy flows
README.md - Privacy SDK → SDK Wallet: exports wallet tools
lib/sdk/index.ts - Privacy SDK → Shield Operations: exports shield tools
lib/sdk/index.ts - Privacy SDK → Network Scanning: exports network tools
lib/sdk/index.ts - Privacy SDK → Proof Builder: exports proof tools
lib/sdk/index.ts - Privacy SDK → Transfer Operations: exports transfer tools
lib/sdk/index.ts - Demo User → Shielded Yield: uses yield
README.md - Privacy SDK → Shielded Yield: supports yield flows
README.md - Armada Relayer → Relayer Wallet: submits transactions
- MCP Server → Contract Queries: routes queries
mcp-server/src/server.ts - MCP Server → Chain Configuration: loads chain roles
mcp-server/src/server.ts - Armada Relayer → Chain Configuration: uses chain topology