Queue Transaction - Sage

POST /queue

Stores a proposed transfer, runs analyzeRisk() inline against the vault’s patterns and policy, and routes it by verdict:

APPROVE (< 40) — server self-calls /execute, broadcasts, and notifies Telegram; returns autoApproved: true and the signature
REVIEW (40–70) — marks in_review, sends a Telegram message with ✅ / ❌ / 🔎 buttons
BLOCK (≥ 70) — marks in_review, sends an urgent Telegram alert

If screeningDisabled is set, the proposal is stored and returned without scoring.

Request

{
  "multisigAddress": "…",
  "vaultAddress": "…",
  "proposalIndex": 7,
  "to": "…recipient address",
  "amount": "0.5",
  "amountUSD": "82.10",
  "tokenSymbol": "SOL",
  "tokenAddress": "so111…",
  "tokenIconUrl": "https://…",
  "proposedBy": "…",
  "screeningDisabled": false
}

Field	Type	Required	Description
`multisigAddress`	`string`	Yes	Multisig config account
`vaultAddress`	`string`	Yes	Vault (treasury) address
`to`	`string`	Yes	Recipient address
`amount`	`string`	Yes	Human-readable amount
`proposalIndex`	`number`	No	On-chain `transactionIndex` (needed for execution)
`amountUSD`	`string`	No	USD value, used for scoring when present
`tokenSymbol`	`string`	No	Token symbol for display
`tokenAddress`	`string`	No	Token mint (omit / native mint for SOL)
`tokenIconUrl`	`string`	No	Token icon URL for display
`proposedBy`	`string`	No	Proposer address
`screeningDisabled`	`boolean`	No	Skip risk analysis and queue only

Response

{
  "success": true,
  "id": "uuid-of-proposal",
  "risk": {
    "riskScore": 15,
    "verdict": "APPROVE",
    "reasons": ["Recipient is trusted", "…"],
    "triggeredRules": []
  },
  "autoApproved": true,
  "signature": "…"
}

Field	Description
`id`	The stored proposal ID
`risk.riskScore`	Risk score (0–100)
`risk.verdict`	`APPROVE`, `REVIEW`, or `BLOCK`
`risk.reasons`	Human-readable scoring reasons
`risk.triggeredRules`	IDs of any custom rules that fired
`autoApproved`	Present and `true` on APPROVE
`signature`	On-chain signature (present only if auto-approved and executed)

If risk analysis fails (e.g. patterns can’t be loaded), the proposal is still stored and the response includes riskError instead of risk.