Skip to content

SKILL.md

Latest commit

 

History

History
215 lines (164 loc) · 7.14 KB

SKILL.md

File metadata and controls

215 lines (164 loc) · 7.14 KB
Raw

Memba — Agent Skill File

Machine-readable instructions for AI agents (Claude Code, Cursor, Windsurf, etc.) interacting with Memba, the Gno-native multisig & DAO governance application.

What is Memba?

Memba is a web application for managing multisig wallets, DAOs, tokens, and validator monitoring on the Gno blockchain. Built by Samourai.world.

  • Live: https://memba.samourai.app
  • Repo: https://github.com/samouraiworld/memba
  • Chain: Gno Pearl (chain id pearl-1, gno-core's official endpoints), gnoland1 (betanet). Sapphire (sapphire-1) sunsets 2026-09-09; Topaz (topaz-1) was decommissioned 2026-08-12 and Testnet 13 on 2026-07-26 — retired chains' RPCs and indexers refuse connections.

Architecture

  • Frontend: React + Vite SPA deployed on Netlify
  • Backend: Go + ConnectRPC on Fly.io (multisig coordination only)
  • On-chain: Direct ABCI queries to Gno RPC (no backend needed for DAO/token features)
  • Wallet: Adena browser extension (all signing is client-side)

Key API Endpoints

Gno RPC (Direct — no auth needed)

All on-chain data is queried via JSON-RPC POST to the Gno RPC endpoint.

Default RPC: https://rpc.pearl.testnets.gno.land:443

⚠️ data MUST be base64-encoded, and the separator is a colon (pkgpath:path for vm/qrender, pkgpath.Expr() for vm/qeval). Passing the raw string — as these examples did before 2026-07-27 — fails with illegal base64 data at input byte 3. The reply's result.response.ResponseBase.Data is base64 too; decode it to read the output.

Query a realm's Render() output

DATA=$(printf 'gno.land/r/samcrew/memba_dao:' | base64)
curl -s https://rpc.pearl.testnets.gno.land:443 \
  -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"abci_query\",\"params\":{\"path\":\"vm/qrender\",\"data\":\"$DATA\"}}"

Query with a path argument (e.g., proposal #42)

DATA=$(printf 'gno.land/r/gov/dao:42' | base64)
curl -s https://rpc.pearl.testnets.gno.land:443 \
  -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"abci_query\",\"params\":{\"path\":\"vm/qrender\",\"data\":\"$DATA\"}}"

Evaluate a function (e.g., is the feed realm paused?)

DATA=$(printf 'gno.land/r/samcrew/memba_feed_v1.IsPaused()' | base64)
curl -s https://rpc.pearl.testnets.gno.land:443 \
  -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"abci_query\",\"params\":{\"path\":\"vm/qeval\",\"data\":\"$DATA\"}}"
# → ResponseBase.Data (base64) decodes to: (false bool)

Get GNOT balance

curl -s https://rpc.pearl.testnets.gno.land:443 \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"abci_query","params":{"path":"bank/balances/g1ADDRESS"}}'

Memba Backend (ConnectRPC)

Base URL: https://memba-backend.fly.dev

The backend uses ConnectRPC (HTTP/1.1 compatible). Service: memba.v1.MultisigService

Get user profile (public, no auth)

curl -s https://memba-backend.fly.dev/memba.v1.MultisigService/GetProfile \
  -H 'Content-Type: application/json' \
  -d '{"address":"g1ADDRESS"}'

List multisigs for a user (requires auth token)

curl -s https://memba-backend.fly.dev/memba.v1.MultisigService/Multisigs \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer TOKEN' \
  -d '{"userAddress":"g1ADDRESS","chainId":"pearl-1"}'

Gnolove API (Contributor Data)

Base URL: https://backend.gnolove.world

Get contributor leaderboard

curl -s 'https://backend.gnolove.world/stats?time_filter=all'

Get contributor profile

curl -s 'https://backend.gnolove.world/users/USERNAME'

Get tracked repositories

curl -s 'https://backend.gnolove.world/repositories'

Get PR report for a date range

curl -s 'https://backend.gnolove.world/pull-requests/report?startdate=2026-01-01&enddate=2026-03-30'

Get on-chain proposals

curl -s 'https://backend.gnolove.world/onchain/proposals'

Get GovDAO members

curl -s 'https://backend.gnolove.world/onchain/govdao-members'

Gnomonitoring API (Validator Metrics)

Base URL: https://monitoring.gnolove.world

curl -s 'https://monitoring.gnolove.world/validators'

DAO Lifecycle

1. Create a DAO

The frontend generates Gno realm code and deploys via MsgAddPackage.

  • Config: name, description, roles, member addresses, voting threshold
  • Generates: DAO realm + optional channels realm + optional candidature realm
  • Deploy fee: 10 GNOT

2. View DAO

Query Render("") on the DAO realm path to get config, members, proposals.

3. Create Proposal

Call Propose(title, description, category) via MsgCall on the DAO realm.

4. Vote on Proposal

  • Memba DAOs: VoteOnProposal(proposalId, "YES"|"NO"|"ABSTAIN")
  • GovDAO: MustVoteOnProposalSimple(proposalId, "YES"|"NO"|"ABSTAIN")

5. Execute Proposal

Call ExecuteProposal(proposalId) when quorum is reached.

Token Operations

Create GRC20 Token

Deploy via GRC20 factory at gno.land/r/demo/defi/grc20factory. Platform fee: 2.5%.

Query Token Balance

# via vm/qeval
curl -s RPC_URL -d '{"jsonrpc":"2.0","id":1,"method":"abci_query","params":{"path":"vm/qeval","data":"gno.land/r/demo/defi/grc20factory\nBalanceOf(\"SYMBOL\",\"g1ADDRESS\")"}}'

Key Realm Paths

Realm Path
GovDAO gno.land/r/gov/dao
GovDAO Memberstore gno.land/r/gov/dao/v3/memberstore
User Registry gno.land/r/sys/users
GRC20 Factory gno.land/r/demo/defi/grc20factory
MembaDAO gno.land/r/samcrew/memba_dao
MembaDAO Channels gno.land/r/samcrew/memba_dao_channels_v2

Project Structure

frontend/           React + Vite SPA
  src/lib/          Core libraries (DAO, tokens, validators, config)
  src/pages/        Page components
  src/hooks/        React hooks
  src/plugins/      Board/leaderboard plugins
backend/            Go + ConnectRPC server
  cmd/memba/        Server entry point
  internal/         Auth, service, DB
api/                Proto definitions
docs/               Architecture, deployment, planning docs

Development

# Frontend
cd frontend && npm install && npm run dev

# Backend
cd backend && go run ./cmd/memba

# Tests
cd frontend && npx vitest run        # 2570+ unit tests
cd backend && go test -race ./...    # Backend tests

Networks

Network Chain ID RPC
Pearl (current) pearl-1 https://rpc.pearl.testnets.gno.land:443
Sapphire (SUNSET 2026-09-09) sapphire-1 —
Topaz (RETIRED 2026-08-12 — endpoints refuse connections) topaz-1 —
Testnet 13 (RETIRED 2026-07-26 — endpoints refuse connections) test-13 —
Betanet gnoland1 https://rpc.gnoland1.samourai.live:443
MAINNET (launches Fri 2026-09-11; ugnot transferable Mon 2026-09-14; pre-registered HIDDEN, no Memba realms) gnoland-1 https://rpc.gno.land:443 (unverified)

⚠️ gnoland-1 (mainnet) ≠ gnoland1 (betanet) — different chains, one hyphen apart.