API reference
request_step_up
request_step_up(reason, amount_usdc)
Explicitly request human approval before proceeding. Creates a StepUpRequest PDA on-chain and sends a push notification to the vault owner. The agent should await approval before retrying the spend.
Parameters
reasonrequiredstringHuman-readable description of why approval is needed. Shown in the push notification.
amount_usdcrequirednumberThe amount the agent intends to spend once approved.
Example
// Agent wants to spend above the step-up threshold
const approval = await rein.requestStepUp({
reason: 'Booking a flight for the research task',
amount_usdc: 47.00
});
if (approval.status === 'approved') {
await rein.spend({ recipient: "expedia.com", amount_usdc: 47.00 });
}