transfer.send
send(agentId, to, amount) → TransferReceipt에이전트가 다른 주소로 OKRW를 전송하도록 합니다. 제출하기 전에 서버 측에서 에이전트의 온체인 정책을 시행합니다. WaaS가 에이전트를 대신하여 트랜잭션에 서명합니다.
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
agentId | string | ✓ | 에이전트의 UUID입니다. |
to | string | ✓ | 목적지 EVM 주소입니다 (0x로 시작하는 40자리 16진수 문자). |
amount | string | ✓ | 십진수 문자열 형태의 OKRW 금액입니다 (예: '50' 또는 '0.25'). |
반환값
타입:
object 트랜잭션이 온체인에서 확인된 후 txHash, gasUsed, gasCostOKRW 및 userCostOKRW를 반환합니다.
에러
| 코드 | 이름 | 설명 |
|---|---|---|
AGENT_NOT_ACTIVE | AgentNotActive | 에이전트가 PENDING, FROZEN 또는 REVOKED 상태입니다. |
INSUFFICIENT_BALANCE | InsufficientBalance | 에이전트 잔액이 요청된 금액보다 적습니다. |
POLICY_REJECTED | PolicyRejected | 전송이 spendingLimit 또는 allowedTargets를 위반합니다. |
예제
1,000,000 OKRW 전송
{
"agentId": "123e4567-e89b-12d3-a456-426614174000",
"to": "0xRecipientAddress",
"amount": "1000000"
}