주 콘텐츠로 건너뛰기
지출 제어

귀하의 에이전트는 설정한 금액을 초과하여 지출할 수 없습니다.

대시보드에서 각 에이전트에 대해 기간별 허용량과 거래당 한도를 설정하세요. 백엔드가 모든 아웃바운드 결제에서 이를 시행하므로 에이전트의 코드는 이를 우회할 수 없습니다.

대시보드 보기: 에이전트별 지출 권한 - 허용량, 거래당 한도, 기간

자율 에이전트는 실수를 합니다. 그들은 재시도합니다. 그들은 루프를 형성합니다. 그들은 프롬프트 주입을 받습니다. 그들은 가끔 귀하가 승인하지 않은 돈을 지출하려고 합니다.

Blockchain0x 지출 허가는 대시보드에서 소유자가 설정하고 백엔드에서 시행되며, 에이전트의 코드에 의해 시행되지 않습니다. 모든 아웃바운드 결제는 API가 이를 수락하기 전에 활성 허가와 비교되므로 에이전트는 논리적으로 시도하더라도 한도를 초과할 수 없습니다. 귀하의 코드는 API를 통해 허가를 읽어 표시하거나 계획할 수 있지만, 이를 높일 수는 없습니다.

지출 권한이 가진 것

네 가지 차원. 한 번 설정. 모든 곳에서 시행됩니다.

기간별 허용량

allowance_wei는 에이전트가 하나의 period_seconds 창을 통해 보낼 수 있는 총 USDC(기본 단위)입니다. 기간은 하루(86400), 일주일(604800) 또는 30일(2592000)입니다.

거래당 한도

per_tx_wei는 허용되는 최대 단일 발신 결제입니다. 이는 잘못된 호출이 의도한 것보다 더 많은 금액을 이동하지 못하도록 합니다. 이는 기간 수당과는 무관합니다.

유효성 창

start_at과 end_at은 권한이 활성화될 때 바인딩됩니다. 기간 밖에서는 지출을 승인하지 않으므로 예산을 미리 설정하거나 하나가 스스로 만료되도록 할 수 있습니다.

취소

revoked_at는 대시보드에서 권한이 꺼진 시점을 기록합니다. 권한을 취소하면 이후 평가된 모든 결제에 대해 수당이 즉시 0으로 설정됩니다.

대시보드 관리, API를 통한 읽기 전용

에이전트의 키는 자신의 한도를 높일 수 없습니다.

대시보드에서 지출 권한을 생성, 변경 및 취소합니다. API는 이를 읽기 전용으로 노출하며 - 권한을 변경하는 엔드포인트나 SDK 메서드는 없습니다. 그것이 전체 요점입니다: 에이전트가 프롬프트 주입되거나 루프에 갇히면, 자신의 허용량을 확대할 수 없습니다. 왜냐하면 보유한 자격 증명은 그런 권한을 부여받지 않았기 때문입니다.

결제가 활성 권한을 초과하면 백엔드는 체인에 닿기 전에 이를 거부합니다. 자금이 이동하지 않습니다. 귀하의 에이전트는 해당 거부를 다른 실패한 호출처럼 처리하며, 대시보드에서 시도를 확인하여 정당한 경우 권한을 확대할 수 있습니다.

API를 통해 읽기

현재 표시 또는 계획할 수 있는 권한 가져오기.

GET /v1/agents/{id}/spend-permissions는 실시간 값을 반환합니다. 이를 사용하여 UI에서 예산을 표시하거나 에이전트가 결제를 시도하기 전에 남은 여유를 확인할 수 있습니다.

읽기 (CURL)
curl https://api.blockchain0x.com/v1/agents/agt_123/spend-permissions \
  -H "Authorization: Bearer $BLOCKCHAIN0X_API_KEY"
응답
{
  "allowance_wei": "5000000",
  "per_tx_wei": "1000000",
  "period_seconds": 86400,
  "start_at": "2026-05-15T00:00:00Z",
  "end_at": null,
  "revoked_at": null
}
allowance_wei

Total spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.

per_tx_wei

Largest single payment allowed, in base units. "1000000" is 1 USDC. A payment over this is rejected even if the period allowance has room.

period_seconds

허용량이 적용되는 창: 86400(일), 604800(주) 또는 2592000(30일).

start_at / end_at

권한이 활성화되었을 때. end_at은 무기한 권한에 대해 null입니다.

revoked_at

활성 상태에서는 Null; 대시보드에서 철회된 후 타임스탬프. 철회된 권한은 아무것도 승인하지 않습니다.

기간

일, 주 또는 30일.

period_seconds는 세 가지 값 중 하나를 사용합니다. 기간이 변경될 때 수당이 리셋됩니다; per_tx_wei는 기간에 관계없이 모든 단일 결제에 적용됩니다.

86400

1일

604800

1주

2592000

30일

지출 허가는 한 번 설정된 하드 한도로, 모든 곳에서 시행됩니다 - 결제당 승인 워크플로우가 아니며 사람의 개입 확인이 아닙니다. 승인이 필요하거나 다중 서명이 필요한 경우, 이는 별도의 더 무거운 패턴입니다; 허가는 항상 켜져 있는 바닥입니다.

자주 묻는 질문

운영자가 묻는 다섯 가지 지출 권한 질문.

API를 통해 지출 권한을 설정하거나 변경할 수 있나요?

아니요. 지출 권한은 API를 통해 읽기 전용입니다. Blockchain0x 대시보드에서 이를 생성, 변경 및 철회할 수 있으며, GET /v1/agents/{id}/spend-permissions를 통해 코드가 현재 값을 읽어 표시하거나 확인할 수 있습니다. 이는 의도적입니다: 에이전트의 API 키는 자신의 한계를 완화할 수 없으며, 이는 에이전트가 프롬프트 주입되거나 루프에 빠질 경우 원하는 속성입니다. 허용량을 늘리려면 대시보드가 필요합니다.

결제가 권한을 초과하면 어떻게 됩니까?

백엔드는 체인에 닿기 전에 이를 거부합니다 - 자금이 이동하지 않습니다. 집행은 백엔드에 존재하며, 에이전트의 코드에는 존재하지 않으므로 에이전트는 논리가 시도하더라도 이를 우회할 수 없습니다. GET 경로로 권한을 읽어 에이전트에게 남은 여유가 얼마나 되는지 보여주고, payments.create에서의 거부를 다른 실패한 호출을 처리하는 방식으로 처리하십시오.

왜 금액이 달러가 아닌 wei로 되어 있습니까?

Consistency with the rest of the API: every amount is a base-unit string. USDC has 6 decimals, so allowance_wei "5000000" is 5 USDC and per_tx_wei "1000000" is 1 USDC. Strings, not floats - large integers lose precision as JSON numbers, and a base-unit string is unambiguous across languages.

지출 권한이 수신 결제를 제한합니까?

아니요. 권한은 지갑에서 나가는 돈만 관리합니다. 들어오는 USDC는 결코 차단되지 않으며 - 누구나 언제든지 귀하의 에이전트에게 결제할 수 있습니다. 권한을 아웃바운드 지출에 대한 일방향 밸브로 생각하세요; 인바운드 정산은 payment.received 웹훅에 의해 별도로 확인됩니다.

무언가 잘못된 것 같으면 빠르게 지출을 취소하려면 어떻게 해야 하나요?

대시보드에서 권한을 취소하세요 - 이는 revoked_at을 설정하고 이후에 평가된 모든 결제에 대해 허용량을 0으로 설정합니다. 더 강력한 중지를 위해 에이전트의 API 키를 회전하거나 취소할 수도 있습니다(apiKeys.rotate / apiKeys.revoke), 이는 자격 증명을 완전히 차단합니다. 두 가지 모두 즉각적이며; 권한 취소는 수술적이며, 키 취소는 킬 스위치입니다.
문서에서 지출 권한 참조

예상치 못한 지출이 아닌 한도를 설정하여 지출하세요.

대시보드에서 허용량과 거래당 한도를 설정하세요. 백엔드가 나머지를 처리합니다.