31Third Safe Rebalancer

This skill helps you monitor portfolio drift and prepare/execute policy-compliant rebalances on a Gnosis Safe through the 31Third ExecutorModule.

Best-practice usage:

• - Use one-step execution by default: npm run cli -- rebalance-now.
• Only use separated tools (check_drift, plan_rebalance, execute_rebalance, etc.) if you explicitly understand each step and want manual control.
• If unsure, run help first (npm run cli -- help) and follow that guidance.

Prerequisites

• - Node.js 22+
• npm

Local Setup

CODEBLOCK0

Getting Started

If you have not deployed your policy stack yet, deploy it first:

Set required environment variables:

CODEBLOCK1

INLINECODE7 (31Third API key) can be requested via or by emailing dev@31third.com.

Wallet model and key handling:

• - Safe owner wallet: controls Safe ownership/governance operations. Never share this private key with the skill.
• Executor wallet: configured as executor on ExecutorModule in the wizard. This private key is required by the skill for execute_rebalance.
• The final step of the 31Third wizard provides an overview of all required environment variables. Use that as source of truth when configuring this skill.

What This Skill Does

• - Reads active on-chain policies from ExecutorModule.
• Computes current-vs-target drift (check_drift).
• Validates trades against Asset Universe + Slippage boundaries (validate_trade).
• Runs a configurable heartbeat monitor (automation) and returns an alert payload when drift exceeds threshold.
• Simulates and executes approved rebalance batches (execute_rebalance) with pre-execution checkPoliciesVerbose validation and one retry on unknown execution failures.
• Accepts SDK plan_rebalance output directly for execution (txData + requiredAllowances) and decodes batch trade calldata internally.
• Fast-fails execution if scheduler != registry on the ExecutorModule, printing both addresses.
• Generates SDK-based policy-aware trade plans (plan_rebalance) using current Safe balances (bounded by Asset Universe when present) as baseEntries.
• Provides one-command execution (rebalance_now) for non-technical users: drift check -> SDK plan -> execution.
• Returns setup and capability guidance (help).

Execution Safety

Before execution, the agent provides a clear reason, for example:

• - INLINECODE26

The skill uses:

• - Viem publicClient for all reads.
• Viem walletClient for execution.

Execution Contract (Important)

When using SDK/trading-api rebalancing output, execution must follow this exact pattern:

1. 1. Build approvals from requiredAllowances as (tokenAddress, neededAllowance).
2. Decode txData as batchTrade(trades, config).
3. Re-encode encodedTradeData as ABI tuple:

1. 4. Run checkPoliciesVerbose(tradesInput, configInput) before submitting.
2. Read scheduler and registry from ExecutorModule.
3. Ensure the signing executor wallet address equals registry (required by onlyRegistry).
4. Only execute immediate path (executeTradeNow(approvals, encodedTradeData)) when scheduler == registry.
5. If scheduler != registry, fail fast and show both addresses.

This is the required execution semantics for this skill and should not be changed to raw passthrough calldata execution.

CLI

Run the bundled CLI:

CODEBLOCK2

Read-only smoke preflight:

CODEBLOCK3

Notes

• - This skill is automation infrastructure, not investment advice.
• Validate behavior in test/staging before running in production.