Title: X402 Imefafanuliwa: Malipo Madogo ya Asili ya HTTP kwa Ajili ya AI Agents

Maelekezo ya X402 yanatumia tena hali ya kawaida ya HTTP 402 Payment Required ili kugeuza mwito wa API wa kawaida kuwa malipo madogo ya on-chain. AI agents sasa zinaweza kulipia ada za maswali ya LLM au vyanzo vya data bila binadamu, na watoa huduma wanaweza kutoza kwa kila ombi bila kujenga mfumo maalum wa ankara.

Kwa nini AI agents zinahitaji itifaki ya malipo

AI agents zinazojitegemea huunganisha mifumo ya lugha (language models), zana za utafutaji wa mtandao, na vyanzo vya data vya kipekee. Kila muunganisho una gharama yake—ada ya kila token kwa mfumo au gharama ya kila mwito kwa API ya data ya soko. Mifumo ya biashara ya leo inategemea funguo za API zilizounganishwa na akaunti za usajili, kuongeza salio kwa mkono, au malipo ya baadae. Njia hizo zinavunja ahadi ya "bila binadamu" ya AI agents zinazojitegemea na kuongeza mzigo wa kiutendaji kwa watoa huduma.

X402 inatoa suluhisho la kati: mtiririko wa ombi-na-jibu (request-response flow) unaoonekana kama mwito wowote mwingine wa HTTP, lakini ukiwa na hatua ya malipo iliyojengwa ndani iliyoandikwa kwenye blockchain ya umma. Hitaji pekee ni kwamba mteja (client) aweze kusaini na kutangaza muamala kwenye blockchain ambayo seva imebainisha.

Hatua za X402 kwa undani

  1. Ombi la awali – Agent hutuma GET au POST ya kawaida kwenye endpoint ya kulipia. Hakuna vichwa vya habari (headers) maalum vinavyohitajika.
  2. Seva inajibu kwa 402 – Jibu hubeba hali ya 402 na mwili wa JSON unaoorodhesha:
    • amount – ada ambayo seva inatarajia, katika kitengo kidogo zaidi cha token;
    • token – anwani ya mkataba wa ERC-20 (au inayolingana);
    • chain – utambulisho wa blockchain ambapo malipo lazima yaandikwe;
    • nonce (hiari) – thamani ya kipekee inayozuia mashambulizi ya kurudia (replay attacks).
  3. Mteja huandaa malipo – Agent hukagua anwani ya token na blockchain dhidi ya sera yake (kwa mfano, blockchain zinazoaminika tu). Kisha hutengeneza muamala unaohamisha kiasi kinachohitajika kwenda kwenye anwani iliyotolewa na seva, huusaini kwa kutumia funguo yake ya siri (private key), na kuutangaza.
  4. Uwasilishaji wa hash ya malipo – Hash ya muamala inapopatikana, mteja hurudia ombi la awali, safari hii akiongeza kichwa cha habari cha X-Payment chenye hash hiyo. Maudhui (payload) yanabaki bila kubadilika.
  5. Seva inathibitisha kwenye blockchain – Seva hutafuta kwenye blockchain uhamisho uliothibitishwa unaoendana na kiasi, token, blockchain, na nonce. Ikipata inayolingana, hurudisha data iliyoombwa ikiwa na hali ya 200 OK.

Maktaba yoyote ya mteja wa HTTP (HTTP client library) inayounga mkono vichwa vya habari maalum na inayoweza kuita SDK ya blockchain inaweza kutekeleza hatua hizi. Hakuna itifaki mpya ya usafirishaji au tabaka la socket maalum linalohitajika.

Mambo ya kuzingatia (Trade-offs)

  • Ucheleweshaji (Latency) – Uhakiki wa blockchain ya umma huongeza ucheleweshaji.
  • Gharama za gas – Hata blockchain rahisi hutoza gas; malipo chini ya $0.001 yanaweza kuwa hayafai kiuchumi.
  • Uchangamano – AI agents lazima washughulikie miamala iliyofeli na mabadiliko ya muundo wa blockchain (chain reorganizations); mantiki thabiti ya kujaribu tena (retry logic) ni lazima.
  • Usalama – Nonce inazuia mashambulizi ya kurudia, lakini AI agents bado wanahitaji kulinda funguo za siri na kuepuka kuzitumia tena kwenye huduma zisizohusiana.