@sage-protocol/sdk 0.0.7 → 0.0.8

package/README.md

@@ -212,6 +212,36 @@ const tx = await sdk.governance.buildDelegateSelfTx({ provider, governor, accoun
 // send via userOp (CDP) or EOA
 ```
 
+Votes token resolution and gates
+```js
+// Resolve the IVotes token used for proposals
+const votesToken = await sdk.governance.resolveVotesToken({ provider, governor });
+
+// Build preferred self-delegate using resolved token
+const del = await sdk.governance.buildDelegateSelfPreferred({ provider, governor, account: user });
+
+// Delegate and verify votes (no throw)
+const res = await sdk.governance.delegateSelfAndVerify({ provider, governor, account: user, signer, minVotes: 1n });
+// → { txHash, ok, votes, payload }
+
+// Readiness to propose (preflight)
+const gates = await sdk.governance.ensureProposeGates({ provider, governor, proposer: user });
+// Optionally include execution check (registry update as timelock)
+const ready = await sdk.governance.readinessToPropose({
+  provider,
+  governor,
+  proposer: user,
+  execution: { registry, timelock, subdao, libraryId: 'main', manifestCID, promptCount: 12 },
+});
+```
+
+Subgraph normalization
+```js
+// listProposalsFiltered now returns both state (string) and stateNum (0–7)
+const items = await sdk.subgraph.listProposalsFiltered({ url: SUBGRAPH_URL, governor });
+// item.state → 'PENDING' | 'ACTIVE' | ... ; item.stateNum → 0..7 or null when unknown
+```
+
 Proposal timeline (subgraph)
 ```js
 const t = await sdk.subgraph.getProposalTimeline({ url: SUBGRAPH_URL, id: idHexOrDecimal });