Web3 / Blockchain Integrations¶
A small but distinct subset of the portfolio is on-chain. These apps live alongside but separate from the main fiat-payment / SaaS apps; they don't share the unified payment-gateway service.
Portfolio map¶
| App | Chain(s) | Stack |
|---|---|---|
| akt-giving-garden-main | Ethereum / EVM | wagmi + RainbowKit + Hardhat + The Graph + ethers.js + WalletConnect v2 + Coinbase Wallet SDK + MetaMask SDK + OpenZeppelin |
| chat-governance-hub-main | EVM | wagmi + RainbowKit + OpenZeppelin Governor v4 |
| my-onchainkit-app | Base (Coinbase L2) | wagmi + Coinbase OnChainKit |
| tiny-governance-hub-base44-main | EVM | wagmi + RainbowKit |
| PolyMarketAI | Polygon | Polymarket CLOB API (off-chain matching, on-chain settlement) |
wagmi¶
What it is. React hooks for Ethereum. useAccount, useConnect, useSignMessage, useReadContract, useWriteContract. The de-facto frontend layer for any EVM dApp in 2025–2026.
Used in: akt-giving-garden, chat-governance-hub, my-onchainkit-app, tiny-governance-hub.
viem¶
What it is. Modern, TypeScript-first Ethereum library. Replaces ethers.js for new code. wagmi is built on viem internally.
Used in: all of the wagmi apps (transitive dependency).
ethers.js¶
What it is. The original "ethers" Ethereum library — Wallet, Contract, Provider classes.
Used in: akt-giving-garden (kept for legacy contract code). New code in the portfolio uses viem.
RainbowKit¶
What it is. Pre-built wallet-connection UI for wagmi. Drops in a "Connect Wallet" button that supports MetaMask, WalletConnect, Coinbase Wallet, Rainbow, and dozens more.
Used in: akt-giving-garden, chat-governance-hub, tiny-governance-hub.
Coinbase OnChainKit¶
What it is. Coinbase's React component library specifically for Base (their L2). Pre-built <Wallet />, <Transaction />, <Identity /> components, smart-wallet support out of the box.
Used in: my-onchainkit-app — built on top of Base specifically.
Hardhat¶
What it is. Ethereum dev environment — local node, contract compile, test runner, deploy scripts, gas reporter.
Used in: akt-giving-garden (smart-contract development).
Tradeoffs / alternatives. Foundry is the current ascendant alternative (Solidity-based tests, faster). akt-giving-garden uses Hardhat; new portfolio Web3 apps could go either way.
The Graph¶
What it is. Indexing protocol for blockchain data. Subgraphs are GraphQL APIs that return on-chain events / state in a queryable form.
Used in: akt-giving-garden — historical on-chain data for the giving-garden contracts.
OpenZeppelin Contracts¶
What it is. Audited reference implementations of common smart-contract patterns: ERC-20, ERC-721, ERC-1155, AccessControl, Governor, ReentrancyGuard, Pausable.
Used in: - akt-giving-garden — OpenZeppelin contracts (general). - chat-governance-hub — OpenZeppelin v4 Governor (on-chain DAO governance).
Why we use it. Don't roll your own ERC-anything. Bugs in audited code are extremely rare; bugs in custom code are extremely common.
Wallet connectivity¶
| SDK | Apps |
|---|---|
| WalletConnect v2 | akt-giving-garden |
| Coinbase Wallet SDK | akt-giving-garden, my-onchainkit-app |
| MetaMask SDK | akt-giving-garden |
RainbowKit and OnChainKit abstract these — the SDKs are also used directly when finer control is needed.
Polymarket CLOB API¶
What it is. Polymarket's Central Limit Order Book — order matching is off-chain (low latency), settlement is on-chain (Polygon). REST + WebSocket APIs.
Used in: PolyMarketAI — algorithmic prediction-market trading.
Adjacent libraries: NumPy, Scikit-learn, Pandas for ML predictions. Celery for scheduled scraping. NewsAPI + feedparser for news ingest. tenacity for retry/rate-limit handling. python-telegram-bot for trade alerts.
Chain-specific notes¶
- Ethereum mainnet — gas is expensive; the giving-garden uses an L2 in practice.
- Base — Coinbase's L2 on top of Ethereum (OP Stack). Cheap gas, USD-denominated UX. Target chain for OnChainKit-app.
- Polygon — Polymarket runs here. EVM-compatible.
- Solana / Cosmos / Bitcoin — not used. The portfolio is EVM-focused.
Comparison alternatives (not used)¶
| Library | Notes |
|---|---|
| Foundry | Solidity-native dev tools. Hardhat fills the role today. |
| web3.js | Older Ethereum lib. ethers / viem replaced it. |
| Privy / Dynamic / Magic | Embedded-wallet auth (email → wallet). RainbowKit + WalletConnect cover the BYOW use case. |
| Alchemy / Infura / QuickNode SDKs | RPC providers. The wagmi apps use these as the underlying RPC, but no app surface code calls them directly. |
Decision guide¶
Building an EVM dApp in React? wagmi + viem.
Want a polished wallet-connect UI? RainbowKit (general) or OnChainKit (Base).
Writing smart contracts? OpenZeppelin libraries + Hardhat or Foundry.
Need on-chain history / analytics? The Graph subgraph.
Need DAO governance? OpenZeppelin Governor.
Algorithmic on-chain trading? Direct CLOB / DEX APIs (Polymarket pattern).
"Should we add Solana?" Only if a customer needs it — the portfolio's stack is EVM.