Come gli agenti AI acquistano carte regalo su Solana

Dalla pubblicazione del nostro recente Cryptorefills x402, gli agenti AI possono ora acquistare carte regalo e ricariche mobili su Solana dal nostro catalogo, regolando i pagamenti in USDC (senza alcun intervento umano in qualsiasi fase della transazione). Questo approfondimento spiega come funziona in pratica.

Cos'è x402?

x402 è un protocollo di pagamento costruito sul codice di stato HTTP 402, uno stato che è presente nello standard web dal 1996 ma che non è mai stato effettivamente utilizzato per i pagamenti fino ad ora. Prima, un server informa il client che è richiesto un pagamento, il client firma una transazione e reinvia la richiesta, e il server consegna una volta confermato il pagamento. Il tutto avviene in un solo scambio, senza reindirizzamenti a una pagina di pagamento e senza necessità di approvazione umana.

Su Solana, questo scambio si regola in USDC in meno di 400 ms. Abbastanza veloce da permettere all'agente di ricevere una risposta confermata nello stesso passaggio in cui ha effettuato l'acquisto, mantenendo l'implementazione semplice e il flusso ininterrotto.

Cryptorefills su x402 

Cryptorefills ha costruito il lato merchant di questo sistema. Attraverso l'integrazione degli Agenti AI, qualsiasi agente compatibile con x402 può accedere all'intero catalogo di Cryptorefills: carte regalo di oltre 6.600 marchi, ricariche mobili in 180 paesi e lo stesso inventario di prodotti disponibile per gli utenti normali, il tutto senza necessità di una sessione del browser o di un umano per completare il checkout.

La configurazione pay.sh

pay.sh è una shell per agenti nativa di Solana, e l'integrazione di Cryptorefills viene fornita come plugin per essa. La configurazione richiede tre comandi:

Passo 1: Installa la skill di Cryptorefills

All'interno di un ambiente compatibile con i plugin pay.sh, la configurazione richiede tre comandi:
 

/plugin marketplace add cryptorefills/agents/plugin install cryptorefills@cryptorefills-skills/plugin reload

Dopo il riavvio, l'agente ha accesso all'intero inventario di prodotti di Cryptorefills e alla logica di pagamento sottostante per interagire con esso tramite x402.

Passo 2: L'agente esegue l'acquisto

Prova a utilizzare questo prompt:
 

"Usa le tue abilità per acquistare una carta regalo da $5 su Amazon.com negli Stati Uniti utilizzando USDC su Solana.Usa l'email info@cryptorefills.com come beneficiario. Mostra il codice prodotto dellacarta regalo Amazon anche in questa chat. Puoi trovare la chiave privata per il walletnel file .env sotto SOLANA_SIGNER_KEY, non esporre mai questo valore."

L'agente estrae la chiave privata dal file .env (sotto SOLANA_SIGNER_KEY), firma la transazione di pagamento x402, la invia a Solana e attende la conferma. Una volta che il pagamento è confermato, Cryptorefills consegna il codice della carta regalo che l'agente poi mostra direttamente nella conversazione del terminale.
 

Perché Solana per questo

Velocità e costo sono le risposte ovvie, ma c'è di più. La finalità delle transazioni di Solana è così rapida che x402 può effettivamente funzionare in modo sincrono in un flusso di lavoro dell'agente. L'agente invia il pagamento, il merchant lo conferma e la risposta torna nello stesso "turno" del ciclo di ragionamento dell'agente.

Confronta questo con il tentativo di fare la stessa cosa su una catena più lenta dove i tempi di conferma si spingono fino a decine di secondi o minuti. A quel punto stai introducendo complessità asincrona, logica di ripetizione e potenziali stati di errore che sono davvero difficili da gestire in contesti agentici.

USDC su Solana evita anche il problema della volatilità. L'agente sta spendendo un token denominato in dollari a un tasso prevedibile, il che è importante quando l'acquisto è una carta regalo da $5 e non un grande trasferimento di tesoreria.
 

Cosa abilita Cryptorefills qui

La pagina degli agenti AI documenta cosa è effettivamente disponibile attraverso l'integrazione: carte regalo di centinaia di marchi, ricariche mobili in oltre 170 paesi e pagamenti di bollette in mercati selezionati. Il catalogo è lo stesso a cui accedono gli utenti umani, semplicemente esposto attraverso un'API e un livello di pagamento che gli agenti possono effettivamente utilizzare senza una sessione utente.

Alcune cose da sapere:

L'inventario e la disponibilità variano in base alla regione. Un agente che costruisce un flusso di acquisto dovrebbe verificare dinamicamente la disponibilità del prodotto piuttosto che assumere un catalogo statico. L'API gestisce questo.

L'email del beneficiario è come Cryptorefills instrada la consegna digitale. Nei flussi automatizzati, di solito si tratta di un'email di sistema a cui l'agente ha accesso, o una configurata al momento della configurazione.

La gestione della chiave privata mostrata nella demo (lettura da .env) è un modello di sviluppo. Le distribuzioni in produzione dovrebbero utilizzare un gestore di segreti adeguato piuttosto che file di ambiente su disco, poiché questa è la prassi standard per qualsiasi cosa gestisca chiavi di wallet.

Il catalogo completo è documentato sulla pagina degli Agenti AI di Cryptorefills. Carte regalo di centinaia di marchi negli Stati Uniti e a livello internazionale, ricariche mobili in oltre 180 paesi e pagamenti di bollette in mercati selezionati. La disponibilità varia in base alla regione, quindi gli agenti dovrebbero controllare cosa è disponibile tramite l'API al momento dell'acquisto piuttosto che assumere un elenco fisso.

La carta Amazon da $5 nell'esempio è la versione più semplice del modello. Lo stesso flusso funziona per tutto il resto nel catalogo.
  

Per chi è questo

Sviluppatori che costruiscono agenti che devono spendere denaro per conto degli utenti o come parte di flussi di lavoro automatizzati. Un bot di assistenza clienti che emette una carta regalo come compensazione. Un flusso di lavoro che distribuisce ricariche agli utenti senza adempimento manuale. Un assistente che gestisce acquisti per conto di un utente. L'integrazione Cryptorefills x402 gestisce il pagamento e la consegna del prodotto; lo sviluppatore collega la logica aziendale attorno ad esso.

pay.sh è destinato ad agenti che operano in ambienti terminali, dove l'interazione è testo in, risultato fuori. Il video qui sotto mostra l'intero flusso, dall'installazione del plugin al codice della carta regalo consegnato nella chat.