మీ ఏజెంట్ మీరు సెట్ చేసిన దానిని మించలేడు.
డాష్బోర్డ్లో ప్రతి ఏజెంట్కు ఒక అనుమతి మరియు ప్రతి లావాదేవీకి ఒక పరిమితిని సెట్ చేయండి. బ్యాక్ఎండ్ ప్రతి అవుట్బౌండ్ చెల్లింపులో దీన్ని అమలు చేస్తుంది - ఏజెంట్ యొక్క కోడ్ దీన్ని దాటలదు.
స్వతంత్ర ఏజెంట్లు తప్పులు చేస్తారు. వారు మళ్లీ ప్రయత్నిస్తారు. వారు లూప్ చేస్తారు. వారు ప్రాంప్ట్-ఇంజెక్ట్ చేయబడతారు. వారు మీకు అనుమతించని డబ్బు ఖర్చు చేయడానికి ప్రయత్నిస్తారు.
Blockchain0x ఖర్చు అనుమతి డాష్బోర్డులో యజమాని-సెట్ చేయబడింది మరియు బ్యాక్ఎండ్ ద్వారా అమలు చేయబడుతుంది, ఏజెంట్ యొక్క కోడ్ ద్వారా కాదు. ప్రతి అవుట్బౌండ్ చెల్లింపు API దీన్ని ఆమోదించే ముందు చురుకైన అనుమతిని పరిశీలించబడుతుంది, కాబట్టి ఏజెంట్ దాని తార్కికత ప్రయత్నించినా పరిమితిని మించలదు. మీ కోడ్ దీన్ని ప్రదర్శించడానికి లేదా దాని చుట్టూ ప్రణాళిక చేయడానికి API ద్వారా అనుమతిని చదవవచ్చు, కానీ దీన్ని పెంచలదు.
నాలుగు కొలతలు. ఒకసారి సెట్ చేయండి. ప్రతి చోట అమలు చేయబడింది.
ఒక కాలానికి allowance
allowance_wei అనేది ఏజెంట్ ఒక period_seconds కిటికీ ద్వారా పంపవచ్చు మొత్తం USDC (బేస్ యూనిట్లు). కాలం ఒక రోజు (86400), ఒక వారం (604800), లేదా 30 రోజులు (2592000).
ప్రతి-లావాదేవీ పరిమితి
per_tx_wei అనేది అనుమతించిన అత్యంత పెద్ద సింగిల్ అవుట్బౌండ్ చెల్లింపు. ఇది ఒక తప్పు కాల్ను మీరు ఉద్దేశించిన దానికంటే ఎక్కువగా కదలకుండా ఆపుతుంది, కాలం అనుమతికి స్వతంత్రంగా.
అవధి విండో
start_at మరియు end_at అనుమతి ప్రత్యక్షంగా ఉన్నప్పుడు బౌండ్ అవుతుంది. కిటికీ బయట ఇది ఖర్చు అనుమతించదు, కాబట్టి మీరు బడ్జెట్ను ముందుగా స్థాయికి చేరవచ్చు లేదా ఒకదాన్ని తన స్వంతంగా ముగియనివ్వవచ్చు.
రద్దు
revoked_at అనుమతి డాష్బోర్డులో నుండి ఆఫ్ చేయబడినప్పుడు రికార్డ్ చేస్తుంది. రద్దు చేయడం, దాని తరువాత అంచనా వేయబడిన ఏ చెల్లింపుకు అనుమతిని వెంటనే శూన్యానికి తీసుకువెళుతుంది.
ఏజెంట్ యొక్క కీ తన పరిమితిని పెంచలదు.
మీరు డాష్బోర్డులో ఖర్చు అనుమతులను సృష్టిస్తారు, మార్చుతారు మరియు రద్దు చేస్తారు. API వాటిని చదవడానికి మాత్రమే ప్రదర్శిస్తుంది - అనుమతిని మార్చే ఎలాంటి ఎండ్పాయింట్ లేదా SDK పద్ధతి లేదు. ఇది మొత్తం విషయం: ఏజెంట్ ప్రాంప్ట్-ఇంజెక్ట్ చేయబడితే లేదా ఒక చక్రంలో చిక్కుకుంటే, అది తన స్వంత అనుమతిని విస్తరించలేడు, ఎందుకంటే అది కలిగి ఉన్న క్రెడెన్షియల్ ఆ శక్తిని ఎప్పుడూ ఇవ్వలేదు.
చెల్లింపు క్రియాశీల అనుమతిని మించిపోయినప్పుడు, బ్యాక్ఎండ్ ఏదీ చైన్ను తాకే ముందు దాన్ని తిరస్కరిస్తుంది. నిధులు కదలవు. మీ ఏజెంట్ ఆ తిరస్కారాన్ని ఇతర విఫలమైన కాల్లతో సమానంగా నిర్వహిస్తుంది, మరియు మీరు డాష్బోర్డ్లో ప్రయత్నాన్ని చూస్తారు కాబట్టి ఇది చట్టబద్ధమైనదైతే అనుమతిని విస్తరించవచ్చు.
దాన్ని ప్రదర్శించడానికి లేదా దాని చుట్టూ ప్రణాళిక చేయడానికి ప్రస్తుత అనుమతిని పొందండి.
GET /v1/agents/{id}/spend-permissions ప్రత్యక్ష విలువలను తిరిగి ఇస్తుంది. మీ UIలో బడ్జెట్ చూపించడానికి లేదా ఏజెంట్ చెల్లింపు ప్రయత్నించే ముందు ఎంత స్థలం మిగిలి ఉందో తనిఖీ చేయడానికి దీన్ని ఉపయోగించండి.
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_weiTotal spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.
per_tx_weiLargest 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 ఓపెన్-ఎండెడ్ అనుమతికి నుల్లుగా ఉంటుంది.
revoked_atసక్రియంగా ఉన్నప్పుడు నల్; డాష్బోర్డులో నుండి రద్దు చేయబడినప్పుడు ఒక టైమ్స్టాంప్. రద్దు చేయబడిన అనుమతి ఏమీ అధికారికంగా చేయదు.
రోజు, వారము, లేదా 30 రోజులు.
period_seconds మూడు విలువలలో ఒకదాన్ని తీసుకుంటుంది. కాలం తిరుగుతున్నప్పుడు అనుమతి పునఃసెట్ అవుతుంది; per_tx_wei ప్రతి ఒక్క చెల్లింపుకు వర్తిస్తుంది కాలం గురించి.
864001 రోజు
6048001 వారము
259200030 రోజులు
ఒక ఖర్చు అనుమతి ఒక కఠిన పరిమితి, ఒకసారి సెట్ చేయబడింది, ప్రతి చోట అమలు చేయబడింది - ఇది ఒక చెల్లింపుకు అనుమతి అనుమతించు పని ప్రవాహం కాదు మరియు ఇది మానవ-లో-లూప్ నిర్ధారణ కాదు. మీరు అనుమతులు లేదా బహు-సంతకం అవసరమైతే, అది ఒక వేరే, భారమైన నమూనా; అనుమతి ఎప్పుడూ ఆ క్రింద ఉన్న ఫ్లోర్.