agent.fund
fund(agentId, amount) → Receipt 소유자 지갑에서 에이전트의 AA 지갑으로 OKRW를 네이티브 전송으로 보내고, 트랜잭션이 확인될 때까지 기다립니다. REVOKED가 아닌 에이전트에는 모두 자금을 보낼 수 있습니다. REVOKED 에이전트로 보낸 OKRW는 다시 회수하거나 전송할 수 없으므로 이 도구는 요청을 거부합니다.
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
agentId | string | ✓ | 자금을 지원할 에이전트의 UUID입니다. |
amount | string | ✓ | 전송할 OKRW 금액으로, 십진수 문자열입니다 (예: '10.5'). |
반환값
타입:
object 트랜잭션이 확인되면 { txHash, agent, amount, unit }를 반환합니다. agent는 에이전트 이름이고, amount는 요청한 십진수 문자열 그대로이며, unit은 "OKRW"입니다.
에러
| 코드 | 이름 | 설명 |
|---|---|---|
AGENT_NOT_ACTIVE | AgentNotActive | 에이전트가 REVOKED 상태입니다. 이 에이전트로 보낸 OKRW는 회수하거나 전송할 수 없으므로 도구가 요청을 거부합니다. 재시도할 수 없으며, 새 에이전트를 만들어 그 에이전트에 자금을 보내야 합니다. |
FUND_FAILED | FundFailed | 소유자의 전송이 실패했습니다. 예를 들어 소유자 지갑의 잔액이 금액과 가스를 합친 값보다 적은 경우입니다. detail에 requestId, errorCode, errorMessage, revertReason이 담깁니다. 재시도 가능합니다. |
예제
에이전트에 1,000 OKRW 자금 지원
{
"agentId": "123e4567-e89b-12d3-a456-426614174000",
"amount": "1000"
}