feat: integrate TrueFi DAO (indexer + API) by alextnetto · Pull Request #1759 · blockful/anticapture

alextnetto · 2026-03-20T10:47:14Z

Summary

Indexer: Full TrueFi DAO integration — stkTRU token (8 decimals) + OZ Governor v1 with bravo counting and 2-day TimelockController
API: TrueFi client for computed proposal statuses (DEFEATED, SUCCEEDED, NO_QUORUM, ACTIVE, PENDING_EXECUTION) via GovernorBase with quorum=for+abstain
Contracts: Governor (0x585CcA06...), Token stkTRU (0x23696914...), Timelock (0x4f4AC7a7...)

Architecture: stkTRU vs TRU

The governor uses stkTRU (staking wrapper) for voting power, not the underlying TRU token. This integration indexes stkTRU for governance, which is correct for proposals/votes/delegation. Key numbers:

Token	Supply	Role
TRU (`0x4C195...`)	~1.45B	Underlying tradeable token
stkTRU (`0x23696...`)	~38M	Staking wrapper, governance token

Only ~2.4% of TRU is staked as stkTRU.

Verified against local RPC (full sync to realtime)

Data	Count
Transfers	5,997
Proposals	71
Votes	627
Accounts	2,012
Delegations	716

Token totalSupply matches on-chain exactly
All proposal vote tallies match on-chain proposalVotes() exactly
Zero data integrity issues (no negative balances, orphaned votes, etc.)

Pending / Follow-up work

TRU token indexing — Circulating supply currently reflects only stkTRU (~38M) not total TRU (~1.45B). CEX/DEX/Lending tracking should be on TRU (the tradeable token). Needs multi-token approach similar to AAVE (AAVE + stkAAVE + aAAVE).
CEX/DEX/Lending addresses — No exchange or DeFi addresses provided yet. Should be researched for TRU once TRU indexing is added.
Dashboard config — apps/dashboard/shared/dao-config/truefi.ts not created. Needed for frontend.

See apps/indexer/src/indexer/truefi/INTEGRATION.md for full details.

Test plan

pnpm indexer typecheck — passes
pnpm indexer lint — passes
pnpm api typecheck — passes
pnpm api lint — passes
Indexer ran to realtime against local RPC with local postgres DB
Cross-validated token supply, proposal votes, and delegate aggregates against on-chain state
Run API with TrueFi DB and verify proposal status endpoints return computed statuses

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Move treasury/token env vars to API, add Railway fallback in dev script, and point client codegen at local gateway endpoint. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Local dev script

…ript Revert "Local dev script"

Move treasury/token env vars to API, add Railway fallback in dev script, and point client codegen at local gateway endpoint. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: local dev script

ERPC

fix: remove header-based DAO resolution from gateful proxy

Add `dotenv --` to indexer, api, gateway, and gateful scripts (matching dashboard) so the root .env is injected into turbo child processes. Bundle OpenTelemetry dependencies into the observability package to avoid the ESM/CJS resolution conflict in @opentelemetry/resources@1.30.x that broke ponder and other consumers. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Step-by-step guide covering all five components (indexer, API, gateway, dashboard, enum sync) with concrete file paths, code patterns, and a verification checklist. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add indexer support for TrueFi DAO with: - Governor (0x585CcA06) - OZ Governor v1, bravo counting, 2-day timelock - Token stkTRU (0x23696914) - ERC20 with delegation, 8 decimals - Events: ProposalCreated, VoteCast, ProposalQueued/Executed/Canceled, Transfer, DelegateChanged, DelegateVotesChanged - Verified against local RPC: 71 proposals, 627 votes, 5997 transfers, token supply matches on-chain exactly Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add TrueFi client extending GovernorBase with: - Quorum calculation: forVotes + abstainVotes (bravo counting) - Timelock delay from on-chain TimelockController.getMinDelay() - Block-relative quorum from governor.quorum(blockNumber) - Contract addresses, CoinGecko mapping, event relevance config This ensures proposals show correct computed statuses (DEFEATED, SUCCEEDED, NO_QUORUM, ACTIVE) instead of raw DB statuses. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel · 2026-03-20T10:47:20Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
anticapture	Ready	Preview, Comment	Mar 20, 2026 11:54am
anticapture-storybook	Ready	Preview, Comment	Mar 20, 2026 11:54am

claude · 2026-03-20T10:47:31Z

Claude encountered an error —— View job

I'll analyze this and get back to you.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a9ef021ab0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-03-20T10:58:20Z

apps/api/package.json

    "lint:fix": "eslint src --fix",
-    "dev": "tsx watch cmd/index.ts",
-    "dev:aave": "tsx watch cmd/aave.ts"
+    "dev": "sh -c 'dao_id=\"$1\"; if [ -n \"$dao_id\" ] && [ -f \"cmd/$dao_id.ts\" ]; then exec tsx watch \"cmd/$dao_id.ts\"; else exec tsx watch cmd/index.ts; fi' --"


Propagate dao_id into the generic API dev entrypoint

When pnpm api dev <dao_id> falls through to cmd/index.ts (anything without its own cmd/<dao>.ts, such as ens or truefi, and even AAVE if it is passed uppercase), the selected DAO is never exported to the child process. cmd/index.ts still reads DAO_ID from .env via apps/api/src/env.ts:6-14, while scripts/dev.sh:107-116 registers that process as DAO_API_<requested>. In the documented local-fallback path where the Railway service is unavailable, pnpm dev truefi can therefore advertise an ENS/UNI API under DAO_API_TRUEFI, so the gateway serves the wrong DAO's data.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-03-20T10:58:20Z

apps/dashboard/.storybook/preview.ts

+const mockApolloClient = new ApolloClient({
+  link: new ApolloLink(() => new Observable(() => {})),
+  cache: new InMemoryCache(),


Make Storybook's Apollo mock settle requests

The Apollo provider introduced here never resolves any operation because its link returns new Observable(() => {}). Components that run Apollo queries during stories now stay permanently loading; for example, EnsAvatar calls useArkhamData(address) whenever an address is supplied (apps/dashboard/shared/components/design-system/avatars/ens-avatar/EnsAvatar.tsx:93-97) and keeps the rendered name in its loading animation while isArkhamDataLoading stays true (...:222-228). As a result, stories like the default ENS avatar never reach their steady state in Storybook.

Useful? React with 👍 / 👎.

…kill Add mandatory Step 0 that verifies the governor's voting token on-chain before writing code. This catches non-standard governance patterns like vote-escrow (veToken) DAOs where the ERC20 token differs from the voting token. Also adds an INTEGRATION.md template for per-DAO status tracking and a new veToken variation row. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Documents the stkTRU vs TRU dual-token architecture, what's integrated, and what's pending (TRU token indexing for distribution analytics, CEX/DEX addresses, dashboard config). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f5ea8e5a8a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-03-20T12:01:58Z

apps/indexer/src/index.ts

+  case DaoIdEnum.TRUEFI: {
+    TrueFiTokenIndexer(token.address, token.decimals);
+    TrueFiGovernorIndexer(blockTime);


Index TRU alongside stkTRU for TrueFi metrics

This wires TrueFi through the single-token path, so every balance-based API for the new DAO is computed from stkTRU only. The new apps/indexer/src/indexer/truefi/INTEGRATION.md already calls out that the liquid asset is the underlying TRU token and that only about 2.4% is staked; with the code as written, /token, /treasury/*, holder tables, and CEX/DEX/Lending supply all underreport TrueFi by design because they never see the much larger TRU balances. The AAVE branch just below shows the pattern needed here: index the governance wrapper and the liquid token separately.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-03-20T12:01:58Z

apps/indexer/src/indexer/truefi/governor.ts

+  ponder.on(`TrueFiGovernor:VoteCast`, async ({ event, context }) => {
+    await voteCast(context, daoId, {
+      proposalId: event.args.proposalId.toString(),
+      voter: event.args.voter,
+      reason: event.args.reason,


Handle VoteCastWithParams in the TrueFi governor indexer

If TrueFi voters use any params-based vote path, those votes are dropped here. The ABI added in this commit declares a VoteCastWithParams event (apps/indexer/src/indexer/truefi/abi/governor.ts), but this indexer only subscribes to TrueFiGovernor:VoteCast, so params-based votes never reach voteCast. In that scenario the indexed vote list and proposal tallies diverge from chain state, which then feeds incorrect quorum/status calculations in the API.

Useful? React with 👍 / 👎.

pikonha and others added 30 commits March 9, 2026 20:03

feat: add erpc dockerfile

b2b4ea1

Merge branch 'dev' into feat/erpc

a97ff57

fix: cn impots and index and types files

ccb30ca

fix: components structure

bf41975

fix: classname, cn import, types and internal market

e3a9f4d

feat: improve storybook organization and fix avatar not loading

2465c74

chore: ignore .claude/settings.local.json to prevent secret exposure

e224230

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat: dev script relying on railway cli

fc8f605

Merge branch 'dev' into chore/local-dev-script

41d7790

feat: add local dev script

677b88d

Merge branch 'dev' into chore/local-dev-script

1bc56b5

feat: state of the art local script

7d0fc4d

chore: enable turbo repo features

21fef18

chore: add local dev skill

5fbf35c

chore: improve local dev experience with env and script fixes

455250c

Move treasury/token env vars to API, add Railway fallback in dev script, and point client codegen at local gateway endpoint. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: dashboard envs

2950e91

Merge pull request #1746 from blockful/chore/local-dev-script

1abad8e

Local dev script

Revert "Local dev script"

eb4e38e

Merge pull request #1748 from blockful/revert-1746-chore/local-dev-sc…

77d2368

…ript Revert "Local dev script"

feat: enable Grafana Drilldown

a346c33

feat: dev script relying on railway cli

0f485fe

feat: add local dev script

e71290f

feat: state of the art local script

56d54f0

chore: enable turbo repo features

3d3736d

chore: add local dev skill

3f8cb16

chore: improve local dev experience with env and script fixes

872e462

Move treasury/token env vars to API, add Railway fallback in dev script, and point client codegen at local gateway endpoint. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: dashboard envs

64f67c4

chore: add gateway healtcheck endpoint

15c4823

fix: links

7746adf

feat: experimental service graph in grafana

f544dd3

pikonha and others added 10 commits March 19, 2026 12:13

fix: api receiving the envs

4b3d991

chore: set limits for chainstack node

403022f

fix(gateful): remove header-based dao proxy resolution

6dd43ab

Merge pull request #1751 from blockful/chore/local-dev-script-v2

2edc358

chore: local dev script

Merge pull request #1754 from blockful/feat/erpc

991bb64

ERPC

Merge pull request #1755 from blockful/codex/fix-gateful-path-only-proxy

49bed5e

fix: remove header-based DAO resolution from gateful proxy

alextnetto requested review from LeonardoVieira1630, PedroBinotto, brunod-e, isadorable-png and pikonha as code owners March 20, 2026 10:47

github-actions bot added API Indexer Dashboard Gateway labels Mar 20, 2026

vercel bot deployed to Preview – anticapture March 20, 2026 10:48 View deployment

chatgpt-codex-connector bot reviewed Mar 20, 2026

View reviewed changes

alextnetto and others added 3 commits March 20, 2026 11:48

Merge branch 'feat/dao-integration-skill' into feat/truefi-integration

904feff

vercel bot deployed to Preview – anticapture-storybook March 20, 2026 11:54 View deployment

vercel bot deployed to Preview – anticapture March 20, 2026 11:54 View deployment

chatgpt-codex-connector bot reviewed Mar 20, 2026

View reviewed changes

pikonha marked this pull request as draft March 20, 2026 18:31

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: integrate TrueFi DAO (indexer + API)#1759

feat: integrate TrueFi DAO (indexer + API)#1759
alextnetto wants to merge 54 commits intomainfrom
feat/truefi-integration

alextnetto commented Mar 20, 2026 •

edited

Loading

Uh oh!

vercel bot commented Mar 20, 2026 •

edited

Loading

Uh oh!

claude bot commented Mar 20, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector bot left a comment

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

alextnetto commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Architecture: stkTRU vs TRU

Verified against local RPC (full sync to realtime)

Pending / Follow-up work

Test plan

Uh oh!

vercel bot commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

claude bot commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot Mar 20, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

alextnetto commented Mar 20, 2026 •

edited

Loading

vercel bot commented Mar 20, 2026 •

edited

Loading

claude bot commented Mar 20, 2026 •

edited

Loading