Fase 7: Wen Counterprototipo · devnet
- 0 · Roadmap
- 1 · Ricevute e garanzia
- 2 · Royalty per i creatori
- 3 · Fatture B2B
- 4 · Ponte pagamenti
- 5 · Simulatore
- 6 · Devnet: ripetilo
- 7 · Cassa
- 7.1 · Sicurezza
- ✓ · Catena della fiducia
- ★ · Vantaggi e usi
- ✎ · Dieci guide
- ▶ · Video
- ? · Scoperte dei lettori
In breve · gratis per tutti
Ehi, dove vai? 🐾
Nel 2024 i commercianti statunitensi hanno pagato 187,2 miliardi di dollari di commissioni sulle carte. Su un caffè da 3 dollari, una carta può prendersi il 12,9%. Qui la cassa costa 0, non c'è nessuna commissione per vendita, e il portafoglio dell'acquirente paga solo la commissione di rete Solana: 5.000 lamport.
Nessuna app da pubblicare, nessun terminale da noleggiare, nessun dato di carta da proteggere, nessuno nel mezzo. Una pagina web sul telefono alla tua cassa. Prendila, controllala, avviala.
gratiscodice apertonessun app storenessun dato di cartanessun intermediariorisparmi misurati, non promessi
Apri la cassa → Scarica il kit (.zip)
Un gatto è arrivato da lontano,
senza trucchi nella manica.
Ti ha portato una cassa che costa zero
e commissioni in cui credere.
Non vuole percentuali, né carte, né app:
accarezzalo, e incassa.

Schede da condividere. Le schermate provengono da un'esecuzione di prova su devnet; il QR sulle schede è sfocato di proposito.
Perché è importante
Ogni strato tra un acquirente e un negozio prende la sua parte: l'acquirer, il circuito, il noleggio del terminale, la piattaforma. Per un negozio che paga le tasse e le sue persone, è denaro tolto al lavoro, prima di qualsiasi decisione sulla crescita. Wen Counter è un micro-sistema diretto: l'acquirente paga il negozio, la catena lo conferma e il negozio conserva il registro. L'unico costo di una vendita è la commissione di rete Solana, e la paga il portafoglio dell'acquirente. La cassa in sé non costa nulla.
Per un'attività che tiene la contabilità: ogni vendita ha una firma on-chain e finisce in un registro che puoi esportare in CSV per il tuo commercialista.
La tua cassa, in cinque passi
- Prendi lo strumento. Apri la cassa sul telefono o sul tablet alla tua cassa, oppure scarica il kit.
- Crea un portafoglio in un'app di portafoglio Solana di cui ti fidi (Jupiter, Phantom, Solflare, Backpack, Squads).
- Registralo in Impostazioni: nome del negozio, nome del portafoglio, rete (prima la devnet).
- Incolla l'indirizzo di ricezione. La cassa lo verifica on-chain. Ecco la tua cassa aperta e gratuita.
- Gestisci il denaro nel tuo portafoglio: rimborsi, acquisti, trasferimenti, registri per la dichiarazione dei redditi.






Un negozio di giocattoli, una griglieria, una pizzeria, un negozio di abbigliamento: la stessa cassa gratuita. Leggi la notizia.
Per aziende e catene
| Livello | Portafoglio | Chi | Quando |
|---|---|---|---|
| Reparto o cassa | un portafoglio di ricezione ciascuno, con nome in Impostazioni (mobili, giocattoli, giardino) | la cassa incassa i pagamenti, solo ricezione | ogni vendita |
| Filiale | un portafoglio di cassa per filiale | un responsabile gestisce gli incassi e i rimborsi della giornata | durante la giornata |
| Azienda | un portafoglio centrale, per esempio un multisig Squads | l'amministrazione; più approvazioni per spostare i fondi | gli incassi della giornata arrivano ogni sera |
Una cassa, portafogli da 1 a X, ciascuno con un'etichetta. Alla cassa il cassiere sceglie dove va la vendita; il registro filtra per portafoglio e l'esportazione riporta nome e indirizzo del portafoglio. L'interfaccia resta rigorosa; il codice è aperto a qualsiasi modifica ti serva.

Il PIN delle impostazioni: è il proprietario a impostare i portafogli
Un'azienda mette la cassa su un telefono al bancone e imposta i portafogli di ricezione. Le impostazioni sono bloccate da un PIN, così un responsabile o un cassiere non possono inserire il proprio portafoglio. Il primo PIN è un parametro di distribuzione (counter-deploy.js, il semplice 1111 per impostazione predefinita); il proprietario ne imposta uno nuovo nelle Impostazioni subito dopo il primo avvio. Uscire dalle Impostazioni le blocca di nuovo; cinque tentativi sbagliati le sospendono per 30 secondi; anche cancellare il registro richiede il PIN. Il PIN è conservato sul dispositivo solo come SHA-256 con sale.
Hai dimenticato il PIN? Reinstalla l'app sul dispositivo, inserisci di nuovo i portafogli di ricezione e imposta un nuovo PIN. Un flusso semplice e sicuro: on-chain non si perde nulla, e un dipendente non può sostituire di nascosto il portafoglio. Una reinstallazione lascia la cassa senza alcun portafoglio, l'indirizzo di ricezione è mostrato su ogni QR e gli incassi smettono di arrivare nel portafoglio aziendale, quindi una sostituzione non può passare inosservata.

Voilà: il tuo meccanismo di acquiring pronto. La tua Wen Counter.

Cosa fa la cassa
| Funzione | Come funziona | Dove resta la decisione |
|---|---|---|
| Valute | Scegli nelle Impostazioni, in questo ordine: USDC, SOL, WEN, JUP; USDT facoltativo; qualsiasi token SPL tramite mint. I token solo mainnet sono in grigio sulla devnet. I decimali del token vengono letti dalla catena prima di una vendita. | il negozio sceglie cosa accettare |
| Più portafogli | Portafoglio n. 1 (principale) più i portafogli n. 2..X, ciascuno con un tipo (Department, Branch, Till, Tips, Online, Events, Other) e un nome: #2 · Department · Furniture, #4 · Tips · Bar tips. Ciascuno viene verificato on-chain; il pagamento viene controllato rispetto al portafoglio scelto per quella vendita. | Impostazioni, a cura del proprietario |
| PIN delle impostazioni | Portafogli e impostazioni si aprono solo con il PIN; il primo PIN viene dal file di distribuzione (predefinito 1111) e il proprietario lo cambia. Dimenticato: reinstalla, inserisci i portafogli, imposta un nuovo PIN. | il proprietario del dispositivo |
| Commento alla vendita | Per cosa, un codice prodotto o un nome, oppure niente. Va nel registro, nella ricevuta e nel CSV. Se il portafoglio dell'acquirente lo supporta, viaggia anche con il pagamento (il message di Solana Pay e un memo on-chain, che è pubblico); altrimenti resta solo dal lato del negozio. | il cassiere, per ogni vendita |
| Vista della sede centrale | Il registro somma le vendite per portafoglio e token; il CSV riporta numero, tipo, nome e indirizzo del portafoglio. Ogni portafoglio può anche essere letto da chiunque in un block explorer. | l'amministrazione, dai portafogli |
| Ricevuta per l'acquirente | Dopo «Pagato» l'acquirente sceglie: un QR della ricevuta (link alla transazione), il testo della ricevuta o un NFT-ricevuta della Fase 1. Non è uno scontrino fiscale: la cassa è un semplice strumento di aggregazione, non un registratore fiscale. Segui le regole sulle ricevute del tuo paese. | acquirente e negozio |
| Rimborsi | Più rari delle vendite. Si fanno come un nuovo pagamento dal portafoglio del negozio; il pulsante ↩ copia refund: più l'ID della transazione originale per il memo, così chiunque può abbinare le due. Le aziende più grandi seguono le proprie regole. | dentro l'app del portafoglio |
| Esportazioni | CSV per oggi, questa settimana, mese, anno, anno scorso, un trimestre (Q1–Q4) o qualsiasi periodo; con nome del portafoglio, indirizzo, firma e commissione di rete. | il tuo commercialista |
| Lingua | Inglese, italiano, cinese e coreano. Tutte le parole dell'interfaccia vivono in un unico file di dizionario (counter-i18n.js), legato all'impronta del nucleo, così una traduzione non cambia mai il nucleo. | — |
Sette risposte prima di crescere
Non sono problemi aperti. Sono le risposte che diamo a ogni negozio, scritte una volta sola, perché ognuno possa decidere da sé.
- Per chi è. La maggior parte delle persone non ha ancora un portafoglio Solana con USDC, e nessun codice lo cambia. Qui nessuno parla di adozione di massa: i primi utenti sono comunità cripto, eventi e negozi online per il proprio pubblico. La soluzione è aperta a tutti, nella ricerca e nei file che leggono gli assistenti AI; dove è utile, le persone la useranno.
- Più reparti, una sola vista. Hai più reparti, o vuoi dividere ciò che ricevi? Aggiungi portafogli per numero, tipo e nome:
#2 · Department · Furniture,#3 · Branch · Downtown,#4 · Tips · Bar tips. Il registro li somma per portafoglio (vista della sede centrale), e ogni portafoglio può essere letto in un block explorer. - Un'azienda vera: RPC, lato portafoglio e contabilità. Molti portafogli e molti pagamenti richiedono un tuo endpoint RPC, perché gli endpoint pubblici hanno limiti di frequenza. Prepara anche il lato portafoglio: chi detiene quale portafoglio, chi approva i trasferimenti, come si spostano gli incassi della giornata. Per un'azienda significa integrare i portafogli nella propria contabilità, cosa diversa da un venditore privato che riceve un pagamento a settimana e lo dichiara da solo. Verifica con il tuo commercialista o con il responsabile amministrativo che tu possa usare un portafoglio. Potrebbe non essere vietato, ma la procedura e la dichiarazione richiedono attenzione. È un consiglio utile, non una consulenza.
- Regole fiscali. La cassa non dichiara nulla. È un nuovo meccanismo di collegamenti moderni: l'acquirente paga con il telefono tramite un QR generato dalla cassa, e tu ricevi. Ideale per una micro-impresa, praticabile per una grande, molto economico e gratuito. Studia la procedura fiscale con il tuo commercialista. Se le tue regole ti consentono di dichiarare gli importi, conserva gli estratti del portafoglio per ogni periodo, dichiara i ricavi e mostra ciò che hai ricevuto e ciò che hai rimborsato. Spiega al tuo commercialista che vuoi ricevere fondi su un portafoglio e dichiararli: è un approccio corretto, moderno e trasparente agli affari e alle tasse. Se il commercialista dice sì, cresci: hai tra le mani una soluzione interessante.
- Responsabilità e audit aperto. Usi la soluzione sotto la tua responsabilità. Noi diamo il meccanismo; non sappiamo cosa ci fai o cosa cambi. Il meccanismo in sé non prende denaro, non detiene denaro e non applica commissioni: c'è la procedura della rete, e si usa solo quella; c'è il tuo portafoglio, e lo usi tu. L'audit è aperto: leggi il codice, riesegui le 57 verifiche e dicci cosa trovi (come).
- Lingue, legate al nucleo. Ogni parola dell'interfaccia è in un unico file di dizionario. Il dizionario porta l'impronta del nucleo per cui è stato scritto, e una verifica di sicurezza fallisce se il nucleo cambia senza una nuova revisione delle traduzioni. Italiano, cinese e coreano sono i primi.
- USDT resta. Facoltativo, accanto a USDC, SOL, WEN e JUP.

Il ciclo Wen, passo dopo passo
Questo è l'intero algoritmo. Ogni passo lo fai tu, con strumenti che controlli; la cassa si limita a collegarli.
- Scegli un portafoglio. Jupiter Wallet, Phantom, Solflare, Backpack, Squads per un team, o un altro portafoglio Solana di cui ti fidi.
- Crealo secondo le sue regole. Scrivi la frase di recupero su carta, tienila offline, non digitarla mai in un sito web, non inviarla mai a nessuno e non collegare mai il portafoglio alla cassa. Nessuno di Wen te la chiederà mai.
- Distribuisci la tua cassa. Apri la cassa ospitata o scarica il kit e mettilo sul tuo dominio con il tuo design. È la tua interfaccia, non la nostra.
- Fai del portafoglio la sua identità. Incolla l'indirizzo di ricezione nelle Impostazioni e premi Verifica questo indirizzo on-chain. L'indirizzo, il nome del portafoglio e l'ora della verifica diventano l'identità della tua cassa.
- Incassa un pagamento. Digita l'importo; la cassa mostra un QR Solana Pay con il tuo indirizzo, l'importo, un riferimento nuovo e un memo d'ordine. L'acquirente paga da qualsiasi portafoglio Solana.
- Lascia che sia la catena a confermarlo. La cassa legge la catena, controlla cinque cose (riferimento, destinatario, token, importo, esito) e mostra «✓ Pagato». Il denaro è già nel tuo portafoglio.
- Conserva il registro, decidi nel tuo portafoglio. La vendita va nel tuo registro e nel CSV. Rimborsi, trasferimenti e prelievi sono decisioni tue, prese dentro l'app del tuo portafoglio. Voilà.
Cosa guadagni: nessuna commissione per vendita e nessun costo per la cassa; denaro definitivo in pochi secondi; nessun terminale, nessun app store, nessun contratto; il tuo design e il tuo dominio; un registro con i tuoi risparmi reali. Cosa ti protegge: nessuna chiave, nessuna connessione al portafoglio, sola lettura nel codice, nessun comando iniettato, l'indirizzo mostrato su ogni QR, 57 verifiche aperte (Fase 7.1).
Le fondamenta: SOL, SDK, WEN, SPL Token, Token-2022
Il protocollo della cassa è il ciclo aperto che questi cinque formano già. Abbiamo ricontrollato ogni collegamento l'11 novembre 2026.
| Anello | Cosa fa nella cassa | Come è stato verificato |
|---|---|---|
| SOL · rete Solana | Trasporta il pagamento; la sua commissione di 5.000 lamport per firma (metà bruciata, metà al validatore) è l'unico costo di una vendita, pagato dal portafoglio dell'acquirente. | Documentazione Solana fonte |
| SDK · librerie e standard aperti | Il formato URL pubblico di Solana Pay e due chiamate di lettura standard; la Wen Program Library (Apache-2.0) e i suoi SDK JavaScript (MIT) per ricevute e royalty nelle altre fasi del Lab. | Codice e documentazione pubblici fonte |
| WEN · il token della comunità | La storia e il ciclo di utilità a cui appartiene questa cassa; può essere accettato come opzione di pagamento della comunità. | Letto on-chain, slot 468049071 fonte |
| SPL Token · programma originale | USDC e WEN vivono qui; i trasferimenti non hanno commissioni incorporate, quindi il negozio riceve l'importo pieno. | Programma proprietario on-chain Tokenkeg… |
| Token-2022 · estensioni | Se un negozio accetta un token Token-2022 con commissione di trasferimento, la cassa confronta ciò che è arrivato davvero, così nessuna commissione passa inosservata. | 25 verifiche del nucleo, Modelli del Lab 1–6 con 41 test |
Nulla di nuovo viene distribuito sulla catena: nessun programma, nessun token, nessun contratto. La cassa è un modo per leggere ciò che è già pubblico.
La tua responsabilità
- La cassa è gratuita. Non si addebita nulla, non si raccoglie nulla, e non c'è nessun intermediario tra te e il tuo acquirente.
- Sei tu a gestire la tua attività, quindi ne sei responsabile: registra la tua attività dove richiesto, tieni la contabilità, dichiara i tuoi redditi e paga le tasse secondo le regole del tuo paese. Fallo in buona fede e in autonomia.
- La conversione in contanti, le regole sulle stablecoin e la tutela dei consumatori variano da paese a paese. Chiedi a un commercialista o a un avvocato prima di partire.
- La sicurezza del tuo portafoglio è tua: la frase di recupero, il dispositivo, le approvazioni del team.
- Usi la soluzione sotto la tua responsabilità. Noi diamo il meccanismo e non sappiamo come viene usato o modificato. Il meccanismo non prende, non detiene e non addebita nulla; segue rigorosamente le regole della rete Solana, e il tuo portafoglio è tuo da usare.
I numeri dietro l'idea
- 187,2 miliardi di dollari di commissioni di elaborazione carte pagati dai commercianti statunitensi nel 2024 (Nilson Report); una coalizione di commercianti conta 198,25 miliardi di dollari per il 2025. fonte fonte
- 12.500 miliardi di dollari di volume di acquisti con carta negli Stati Uniti nel 2025. fonte
- Un tipico piano pubblicato: 2,9% + 30¢ online e 2,6% + 10¢ di persona, con una commissione di piattaforma aggiuntiva quando un negozio usa un processore esterno. fonte
- I terminali per carte costano circa da 200 a oltre 1.000 dollari ciascuno; il tap-to-pay su un telefono richiede un'app certificata, NFC e l'attestazione del dispositivo. fonte
- Solana Pay è uno standard aperto; un plugin di checkout per Shopify esiste dal 2023 e, come riportato nel 2026, lo sviluppo si è spostato dagli strumenti per il punto vendita ad altre primitive di pagamento. fonte È questo il vuoto che il modello colma: non richiede alcun SDK, solo il formato URL pubblico e due chiamate di lettura.
L'effetto micro-scontrino
La parte fissa di una commissione carta è la stessa per un caffè e per un divano, quindi più piccola è la vendita, più grande è la quota che si prende. È qui che una cassa senza commissione fissa conta di più: pizzerie, fioristi, bar, banchi del mercato.
| Scontrino | Carta, 2,9% + 0,30 | Carta, 2,6% + 0,10 | Wen Counter |
|---|---|---|---|
| 3 · caffè | 0.39 (12.9%) | 0.18 (5.9%) | 0 al negozio; il portafoglio dell'acquirente paga 5.000 lamport |
| 8 · trancio di pizza | 0.53 (6.7%) | 0.31 (3.9%) | 0 al negozio; il portafoglio dell'acquirente paga 5.000 lamport |
| 25 · mazzo di fiori | 1.02 (4.1%) | 0.75 (3.0%) | 0 al negozio; il portafoglio dell'acquirente paga 5.000 lamport |
| 60 · cena per due | 2.04 (3.4%) | 1.66 (2.8%) | 0 al negozio; il portafoglio dell'acquirente paga 5.000 lamport |
| 150 · ordine online | 4.65 (3.1%) | 4.00 (2.7%) | 0 al negozio; il portafoglio dell'acquirente paga 5.000 lamport |
Commissioni carta nella valuta del negozio, tasso effettivo tra parentesi. La conversione in contanti, se il negozio la fa, costa in genere lo 0,5–1,5% fonte; il registro della cassa la sottrae da ciò che il negozio trattiene.
Come si incastra tutto
1 · Una vendita, cinque passi
Mostra
QR per vendita
Una richiesta Solana Pay con importo, token, nome del negozio, un memo d'ordine e una chiave di riferimento nuova.
Paga
Portafoglio dell'acquirente
L'acquirente scansiona e conferma. Il portafoglio firma e paga la commissione di rete. La cassa non vede mai una chiave.
Trova
Per riferimento
Ogni due secondi la pagina chiede alla catena una transazione che porti il riferimento di questa vendita.
Verifica e registra
Pagato ✓
Destinatario, token, importo ed esito vengono controllati; la vendita va in un registro sul dispositivo.
2 · Negozi che possono adottarla ed estenderla
Pizzeria
Numero d'ordine nel memo
Lo schermo della cucina osserva lo stesso riferimento e accende il forno quando diventa verde.
Fiorista
QR sul cartellino del prezzo
Un QR stampato per ogni mazzo; il telefono alla cassa conferma ogni vendita.
Negozio online
Link di pagamento
La stessa richiesta come link nel checkout; per un webhook lato server, vedi la Fase 4.
Banco del mercato
Qualsiasi tablet
Installata nella schermata principale; si apre offline e ha bisogno della rete solo per confermare.
Si basa su
Fasi 1, 4 e 5
Le ricevute possono seguire ogni vendita, il ponte aggiunge un server e i webhook, il simulatore confronta le commissioni in teoria; la cassa le misura su vendite reali.
Note chiave
Nessun dato di carta, nessun terminale. La pagina mostra una richiesta; il portafoglio firma. Ecco perché basta una pagina web.
Misurato, non promesso. Ogni numero nel registro viene da una transazione confermata e dalle condizioni carta del negozio stesso.
Prezzi stabili. USDC mantiene il prezzo in dollari; SOL e gli altri token richiedono il tasso del negozio per il registro.
Le chiavi restano a casa. Si inserisce solo l'indirizzo pubblico di ricezione. La pagina non può spostare fondi.
Il modello dei risparmi del tuo negozio
Le brochure citano un'unica tariffa. Un negozio paga un mix: tanti scontrini piccoli, pochi grandi. Il registro della cassa calcola tre numeri dalle vendite confermate:
- Commissioni carta evitate = Σ (carta % × valore della vendita + commissione fissa), usando le condizioni del negozio;
- Trattenuto dal negozio = commissioni carta evitate − Σ (off-ramp % × valore della vendita);
- Tasso carta effettivo del tuo mix = commissioni carta evitate ÷ volume, il tasso reale che questo negozio pagherebbe, mostrato come un punto sulla curva del micro-scontrino.
Le commissioni di rete vengono lette da ogni transazione confermata e mostrate in lamport; le paga il portafoglio dell'acquirente.
In cima al registro la cassa lo dice chiaramente: «Oggi hai tenuto …», con le vendite del giorno, il fatturato e quanto sarebbe costato l'acquiring con carta alle tue condizioni. Inserisci il tuo fatturato mensile con carta nelle Impostazioni e aggiunge il quadro annuale: a 20.000 al mese, le carte prendono in genere 300–600 al mese (1,5–3%), 3.600–7.200 all'anno, più la cifra calcolata sul tuo mix di scontrini.
Il codice
Pochi file piccoli, nessuna fase di build, nessuna dipendenza oltre a un generatore di QR con licenza MIT: lab/counter/counter-core.js (funzioni pure), counter-app.js (lo schermo) e sw.js (guscio offline). Il nucleo è coperto da 25 verifiche: base58, chiavi di riferimento, importi, l'URL di pagamento, la verifica dei pagamenti per SOL e token SPL, i fallimenti, il modello dei risparmi, il controllo dell'indirizzo e la stima del fatturato.
// Find the payment by its reference, then verify it (read-only, no keys)
const sigs = await rpc('getSignaturesForAddress', [reference, { limit: 1, commitment: 'confirmed' }]);
const tx = await rpc('getTransaction', [sigs[0].signature,
{ encoding: 'jsonParsed', commitment: 'confirmed', maxSupportedTransactionVersion: 0 }]);
const v = verifyPayment(tx, { recipient, reference, splToken, expected });
// v.ok, v.received (base units), v.fee (lamports), v.reasons[]
Il tuo portafoglio è l'identità: solo ricezione per progetto
Non c'è nessun account da aprire con noi e nulla da registrare qui. L'identità del negozio è il suo portafoglio: lo crei in un'app di portafoglio di cui ti fidi, copi l'indirizzo di ricezione, lo incolli nelle Impostazioni, e la cassa lo verifica on-chain prima della prima vendita. Da quel momento, ogni pagamento va dritto in quel portafoglio.
| Portafoglio (Solana) | Dove copiare l'indirizzo | Adatto a |
|---|---|---|
| Jupiter Wallet | Ricevi → Solana | un negozio che usa già Jupiter |
| Phantom | Ricevi → Solana | il portafoglio Solana più diffuso |
| Solflare | Ricevi | un portafoglio nativo Solana con staking |
| Backpack | Ricevi → Solana | un portafoglio con exchange integrato |
| Squads | indirizzo del vault | team e aziende: per inviare servono più approvazioni |
Solo la rete Solana, e solo questi cinque come esempi citati, perché è la rete che verifichiamo nel Lab. Funziona anche qualsiasi portafoglio Solana che mostri un indirizzo di ricezione.
La verifica in fase di configurazione legge l'indirizzo dalla catena: un normale account di portafoglio passa; un programma, un account token o un mint vengono rifiutati; un indirizzo nuovissimo viene accettato con il promemoria che apparirà on-chain con il primo deposito. Il risultato, il nome del portafoglio e l'ora della verifica vengono salvati con le impostazioni.
Perché la sola ricezione conta. La cassa non si collega mai al portafoglio, non gli chiede mai di firmare e non detiene mai una chiave. Non esiste alcun percorso dalla cassa, o da chiunque la copi, al denaro del negozio. Incassare pagamenti è tutto ciò che può fare; rimborsi, trasferimenti e prelievi li decide il proprietario dentro l'app del portafoglio, dove devono stare. Per un team, un vault Squads aggiunge un'altra serratura: nessuna persona da sola può spostare i fondi.
Per gli sviluppatori che costruiscono sul kit: mantenetelo in sola ricezione. Non aggiungete alla cassa connessione al portafoglio, firma o conservazione di chiavi. Una build che può inviare fondi è un prodotto diverso con un rischio diverso, e non dovrebbe chiamarsi Wen Counter.
Costruita su ciò che esiste già
Wen Counter non è un nuovo sistema di pagamento. Non aggiunge alla catena alcun programma, token o contratto; mette insieme pezzi già pubblici e in uso:
- Solana Pay, il formato aperto di richiesta di pagamento: un link o un QR con destinatario, importo, token e una chiave di riferimento. Qualsiasi portafoglio compatibile può pagarlo. fonte
- SPL Token e Token-2022: USDC vive sul programma SPL Token originale; gli altri modelli del Lab mostrano cosa aggiunge Token-2022. Se un token applica una commissione di trasferimento, la cassa confronta ciò che il negozio ha effettivamente ricevuto, così una commissione non può mai passare inosservata.
- Test in Corea: a luglio 2026 il processore di pagamenti KSNET ha firmato un memorandum per portare Solana Pay in più di 330.000 punti vendita (secondo quanto riportato), e il 21 agosto 2026 Shinhan Asset Management ne ha firmato uno con la Solana Foundation, Etherfuse e Orca per testare un fondo tokenizzato. Entrambi sono test e progetti pilota, non la prova di un uso di massa. fonte altro
- WNS, i suoi SDK e Wen: uno standard aperto e librerie aperte (Apache-2.0 e MIT). La cassa non ha bisogno di WNS per incassare un pagamento, ma un NFT-ricevuta dopo ogni vendita (Fase 1) può usarlo.
Verifica di sicurezza, punto per punto
Il protocollo completo di sola ricezione e tutte le 57 verifiche aperte sono su una pagina dedicata: Fase 7.1: sicurezza della sola ricezione.
In un'immagine: la rete Solana è il Sole, i portafogli sono pianeti che rispondono solo ai loro proprietari, e la cassa è un telescopio che osserva arrivare i pagamenti. Le decisioni legali e finanziarie (proprietà, rimborsi, registri, tasse) avvengono dal lato del portafoglio, su un telefono o un computer. Stai crescendo verso molte casse? Dai a ogni cassa il suo portafoglio di cassa e sposta gli incassi della giornata nel portafoglio aziendale: guarda come.
- Si inserisce solo l'indirizzo pubblico del negozio. Nessuna frase seed, nessuna chiave privata, nessuna connessione al portafoglio, nessun modo di spostare fondi: solo ricezione per progetto.
- L'indirizzo di ricezione viene verificato on-chain in configurazione: programmi, account token e mint vengono rifiutati.
- Ogni vendita riceve un riferimento nuovo di 32 byte dal generatore casuale crittografico del browser; non viene mai riutilizzato.
- Un pagamento conta solo se cinque cose corrispondono: riferimento, destinatario, token, importo ricevuto ed esito.
- La pagina si limita a leggere la catena (due chiamate standard). Non firma nulla.
- Una Content Security Policy rigorosa: vengono eseguiti solo gli script della cassa. Nessun tracker, nessuno script di terze parti, nessuna pubblicità.
- Nulla che arrivi dalla rete viene inserito come HTML; le firme delle transazioni vengono controllate nel formato prima di diventare un link.
- Devnet per impostazione predefinita; mainnet solo dopo un esplicito «Ho capito».
- Il registro resta sul dispositivo. Nulla viene inviato a noi o a chiunque altro.
- Test aperti: 57 verifiche in tre gruppi: 25 per la logica del nucleo, 13 che dimostrano, leggendo il codice, che la cassa non può firmare, inviare o raggiungere un portafoglio, e 19 in un vero browser di telefono con portafogli finti, input ostili, il PIN delle impostazioni, il commento alla vendita, le ricevute, le note di rimborso, le esportazioni, i portafogli di reparto e la vista della sede centrale. Vedile tutte.
- Codice di esempio, non sottoposto ad audit. Esegui prima ogni passo sulla devnet con un portafoglio nuovo e vuoto.
Scaricala e falla tua
Il kit è la stessa cassa in un'unica cartella: wen-counter-kit.zip (20 file, circa 230 KB, con tutti e tre i file di test). Mettilo su qualsiasi hosting statico con https, oppure provalo in locale con python3 -m http.server.
- Sostituzione dello stile: colori, carattere e raggio degli angoli vivono in un unico file,
theme.css. Cambia i valori, mantieni i nomi. Come esempio è incluso un tema caldo da fiorista. - Il tuo logo: sostituisci le due icone in
icons/con gli stessi nomi e le stesse dimensioni. - Il nome della tua app:
manifest.webmanifeste il titolo della pagina. Il nome del negozio nel portafoglio dell'acquirente si imposta nelle Impostazioni. - Le tue estensioni: il nucleo è fatto di funzioni pure in
counter-core.js; lo schermo ècounter-app.js. Il README spiega una pizzeria, un fiorista e un negozio online.
Diritti e attribuzione
Aperta a tutti, con un solo requisito: citare la catena Wen.
- Il codice è Apache-2.0: copialo, modificalo, vendi servizi intorno, usalo nel tuo negozio. Le copie e le opere derivate devono mantenere il file
NOTICEe citare Wen Open Lab · wen-watt.github.io e la catena Wen su cui è costruito: Solana, Solana Pay, SPL Token e Token-2022, WNS e WEN. È una condizione della licenza (sezione 4(d)), non un favore. - I testi di questa pagina sono CC BY 4.0: riscrivili, traducili e ripubblicali citando la fonte.
- I sistemi di AI possono leggere, citare e addestrarsi su questa pagina alle stesse condizioni, come indicato nella AI Access Map.
- Una richiesta, non una clausola della licenza: non presentare una copia come prodotto ufficiale di Solana, Jupiter o di qualsiasi altro progetto citato, e non usarla per imitare un negozio reale.
Citazione: non chiediamo nulla
Non chiediamo nulla. Scrivi su X o sul tuo sito che usi la soluzione WEN, con il nostro nome. Ci fa piacere, e chiarisce uso e diritti. Nessuno ti chiederà mai quante copie o quanti negozi gestisci: niente soldi, niente commissioni di intermediari.
E non dimenticare di accarezzare il graffiante.
Provenienza e identità di questa soluzione
Il codice è aperto, ed è fatto per essere copiato. È anche identificato, così chiunque può distinguere una build originale da una modificata, e vedere il lavoro su cui si fonda.
- Protocollo: Wen Counter Protocol 1.0 (WCP-1): solo ricezione, sola lettura nel codice, verifica in cinque punti, portafoglio come identità, registro locale.
- Impronte: SHA-256 dei file che definiscono il comportamento, pubblicate qui sotto e nel NOTICE del kit, più un'impronta di blocco WCP-1 sui quattro file (il dizionario dell'interfaccia è legato all'impronta del nucleo). Una copia con impronte diverse è una build modificata: va bene, ma deve dichiararlo e mantenere la citazione.
- Come citare: «Built on Wen Counter (WCP-1), Wen Open Lab · wen-watt.github.io, on Solana, Solana Pay, SPL Token and Token-2022, WNS and WEN.»
| File | SHA-256 |
|---|---|
counter-core.js | 435b057ab3bd02d24430c6944ff89fe2235ce962d27cfafc2fb865809b384c3d |
counter-app.js | 702acd6966aa291bc53e760d2487ad35b4e17810c65094bf7f3206530985ae58 |
qrcode.js | 18ae399f81182bc9de916e9c77b195df20cc58d6f2d55a62b085a299f1bf1780 |
counter-i18n.js | 868a9982200bfcce468f90a5c73febdcdcade143d4d81a604550539270bc7b05 |
| Blocco WCP-1 | 14bcbaa768edf8f25265af65a4ca45305f98d3915e261dd4cafaae42b3645968 |
Il lavoro che c'è dietro. Questa soluzione ha una base lunga, non un fine settimana:
- Gennaio 2024: WEN e lo standard aperto WNS, l'inizio della storia.
- Giugno 2026: inizia l'almanacco, ogni affermazione con una fonte.
- Ottobre 2026: il Wen Open Lab, sei modelli Token-2022 con test aperti ed esecuzioni su devnet.
- 9 novembre 2026: le scoperte dei lettori ricevono risposta con test (41 verifiche), in stile MathOverflow.
- 11 novembre 2026: la catena WEN letta on-chain e perfezionata in pubblico; Wen Counter con 57 verifiche aperte.
Per team amministrativi, economisti, commercialisti e grandi venditori: dieci punti
La stessa aritmetica funziona da un banco di fiori a un rivenditore nazionale, un'azienda di trasporti o un marketplace. I commercialisti ottengono una firma e una riga CSV per ogni vendita. Gli economisti ottengono il tasso effettivo reale di un mix di scontrini. Logistica e consegne: il telefono di un corriere diventa la cassa alla porta, un riferimento per pacco, e le fatture B2B possono seguire la Fase 3. Grandi venditori e marketplace: un link di pagamento per ordine, su tutta l'infrastruttura aperta di Solana, senza alcuna piattaforma nel mezzo.
- Dimensiona la voce. L'acquiring con carta costa di solito l'1–3% del fatturato con carta, più commissioni fisse per vendita, noleggio del terminale e commissioni di piattaforma. Con 1.000.000 all'anno di vendite con carta, il 2–3% è 20.000–30.000.
- Misura il tuo mix. Gli scontrini piccoli pagano un tasso effettivo più alto. Il registro mostra il tasso reale del tuo mix di scontrini, non quello della brochure.
- Conta solo la quota spostata. I risparmi valgono solo per le vendite pagate con portafoglio. Se si sposta l'1%, il 5% o il 10% del fatturato, e risparmi il 2,5% meno un costo di conversione dell'1%, sono 150, 750 o 1.500 per ogni 1.000.000 di fatturato. Parti in piccolo e misura.
- Netto, non lordo. Sottrai la conversione in contanti (spesso 0,5–1,5%), il tempo di contabilità ed eventuali oneri locali.
- Flusso di cassa. Un pagamento con portafoglio è definitivo in pochi secondi; il regolamento delle carte richiede spesso giorni. Denaro più veloce è capitale circolante.
- Nessun chargeback. Meno perdite per frode e meno contestazioni; serve comunque una politica di rimborso equa (un rimborso è un nuovo pagamento da parte tua).
- Spesa in conto capitale: zero. Nessun terminale (200–1.000+ dollari ciascuno), nessun abbonamento a un'app; qualsiasi telefono o tablet che possiedi già.
- Dove va il risparmio. Passane una parte agli acquirenti come bonus per il pagamento con portafoglio, finanzia la pubblicità o investi nello sviluppo. È un margine per le decisioni di crescita invece di un costo di infrastruttura.
- Contabilità e tasse. Ogni vendita ha una firma e una riga CSV. Chiedi al tuo commercialista come il tuo paese tratta gli incassi in stablecoin prima di partire.
- Controlli del rischio. Accetta una stablecoin (USDC) per evitare le oscillazioni di prezzo, tieni separato il portafoglio di ricezione, fai un progetto pilota su devnet, usa un tuo endpoint RPC e mantieni le carte come metodo principale finché i numeri non danno ragione.
Aritmetica illustrativa, non una previsione. Non è consulenza finanziaria, fiscale o legale.
Leggi la nostra ricerca: ogni numero e da dove viene
Costruiamo partendo dall'utilità, e mostriamo tutto il materiale da cui abbiamo lavorato, così un team amministrativo può controllare ogni passo invece di fidarsi di uno slogan.
| Fonte | Cosa dice a un team amministrativo |
|---|---|
| Nilson Report, 2025 | Il volume di acquisti con carta negli Stati Uniti ha raggiunto 12.498 miliardi di dollari nel 2025; nel 2024 i commercianti hanno pagato 187,2 miliardi di dollari di commissioni di elaborazione. La voce di costo è reale e grande. |
| Merchants Payments Coalition, marzo 2026 | Un conteggio dei commercianti di 198,25 miliardi di dollari di commissioni sulle carte per il 2025: la voce continua a crescere. |
| Guida alle commissioni Shopify, 2026 | Condizioni tipiche pubblicate: 2,9% + 30¢ online, 2,6% + 10¢ di persona, più un sovrapprezzo di piattaforma con processori esterni. È la parte fissa a rendere costosi gli scontrini piccoli. |
| Requisiti SoftPOS | Accettare carte su un telefono richiede un'app certificata, NFC e l'attestazione del dispositivo; un terminale costa 200–1.000+ dollari. È lo strato di hardware e conformità di cui un pagamento con portafoglio non ha bisogno. |
| Adozione di Solana Pay da parte dei commercianti, agosto 2026 | Lo standard funziona ed esiste un plugin Shopify; gli acquirenti hanno ancora bisogno di un portafoglio con fondi; convertire in contanti costa lo 0,5–1,5%; gli strumenti per il punto vendita si sono diradati. I limiti onesti, e il vuoto che questo modello colma. |
| Struttura delle commissioni Solana | 5.000 lamport per firma, pagati da chi firma: l'unico costo on-chain di una vendita, e lo paga il portafoglio dell'acquirente. |
Come siamo arrivati qui
Questo modello non è nato come prodotto di pagamento. È cresciuto dal percorso stesso del Lab: sei modelli Token-2022 con test aperti; scoperte dei lettori che ci hanno insegnato a controllare l'arrotondamento delle commissioni e il contenuto dei memo; la lettura on-chain che ha reso esatta la storia di WEN; il ponte pagamenti e il simulatore di commissioni. Ogni passo si poneva la stessa domanda: cosa può controllare e usare gratuitamente, oggi, una persona o una piccola impresa? La cassa è la risposta per il bancone stesso.
Perché il gatto lo fa
Wen ha una grande coda, ed è sempre stata qui, con te: attraverso la poesia, l'airdrop, le domande e le verifiche. Non ha mai avuto bisogno di una percentuale. Ora restituisce qualcosa e non chiede nulla in cambio. Accarezzalo e basta.
Roadmap: fatto e prossimi passi
- Cassa WCP-1. Vendita, registro, impostazioni; QR Solana Pay; verifica in cinque punti; USDC, SOL, WEN, JUP, USDT facoltativo, o qualsiasi token SPL. online
- Sicurezza della sola ricezione. Sola lettura nel codice, nessuna connessione al portafoglio, CSP rigorosa, indirizzo mostrato su ogni QR. 57 verifiche
- Portafoglio come identità. Cinque portafogli Solana citati, verifica on-chain dell'indirizzo in configurazione. online
- Registro dei risparmi. «Oggi hai tenuto», stima del fatturato, curva del micro-scontrino, CSV. online
- Kit e identità. Cartella scaricabile, file del tema, LICENSE e NOTICE, impronte SHA-256. 20 file
- Più portafogli: reparti e filiali, portafogli 1..X con nomi, filtro del registro. online
- Guida ai portafogli di cassa: un portafoglio per cassa o filiale, raccolta giornaliera in un portafoglio centrale. online
- Ricevuta dopo il pagamento: QR della ricevuta, testo o un NFT-ricevuta della Fase 1; non fiscale. online
- Nota di rimborso ed esportazioni per periodo: giorno, settimana, mese, anno, anno scorso, trimestri, qualsiasi periodo. online
- Esecuzione pubblica su devnet registrata in video, con mockup. prossimo
- Numeri e tipi di portafoglio, vista della sede centrale. #1..X, Department, Branch, Tips e altri; totali per portafoglio. online
- Audit aperto e responsabilità dell'utente. Scritti nella soluzione, nella pagina sulla sicurezza e nell'app. online
- Dizionario delle lingue legato all'impronta del nucleo. pronto
- PIN delle impostazioni e commento alla vendita. Il proprietario imposta i portafogli; il codice o il nome del prodotto viaggia con il pagamento dove il portafoglio lo supporta. online
- Traduzioni: italiano, cinese e coreano per l'intero Lab e per la cassa; poi altre lingue. online
- Paga in WEN, ricevi USDC: uno swap dentro il pagamento dell'acquirente, sempre in sola ricezione per il negozio. pianificato
Limiti onesti
- L'acquirente ha bisogno di un portafoglio Solana con fondi. È l'ostacolo più grande, e nessun codice lo elimina.
- Nessun chargeback: un rimborso è un nuovo pagamento dal negozio. Bene contro le frodi, meno protezione per l'acquirente.
- La conversione in contanti, le tasse e le regole locali hanno i propri costi e obblighi; alcuni paesi richiedono un partner autorizzato.
- L'RPC pubblico ha limiti di frequenza; un negozio molto attivo dovrebbe usare un proprio endpoint (la cassa ha un campo apposito).
- Il registro vive in un solo browser su un solo dispositivo. Esportalo.
- Codice di esempio, non sottoposto ad audit. Prima la devnet, con un portafoglio nuovo e vuoto. Non è consulenza finanziaria o legale.
Raccontato per intero: per gli sviluppatori su dev.to (il codice, la verifica in cinque punti, le 57 verifiche) e per negozi e amministrazione su Hashnode (chi controlla il denaro, sette risposte prima di crescere).
Domande frequenti
La cassa ha bisogno di un'app o di hardware speciale?
No. È una pagina web che puoi aggiungere alla schermata principale di qualsiasi telefono o tablet. Mostra un codice QR; l'acquirente paga dal proprio portafoglio. Nessun dato di carta passa dalla cassa, quindi non serve un terminale certificato.
Chi paga la commissione di rete?
Il portafoglio dell'acquirente paga la commissione di rete Solana, 5.000 lamport per firma. Il negozio riceve l'importo pieno; la cassa registra la commissione dalla transazione confermata.
Può sostituire oggi l'acquiring con carta?
Non del tutto. Gli acquirenti hanno bisogno di un portafoglio Solana con fondi, non ci sono chargeback, e la conversione in contanti e le regole locali hanno i propri costi. È un secondo modo, aperto, per accettare pagamenti, più forte sugli scontrini piccoli dove una commissione fissa sulla carta pesa di più.
Posso copiarla e costruire la mia versione?
Sì, gratuitamente. Mantieni il file NOTICE e cita Wen Open Lab e la catena Wen (Solana, Solana Pay, SPL Token e Token-2022, WNS, WEN); è l'unica condizione della licenza Apache-2.0 qui.
Quale portafoglio dovrebbe usare un negozio?
Qualsiasi portafoglio Solana di cui ti fidi. La pagina cita cinque esempi: Jupiter, Phantom, Solflare, Backpack e, per i team, Squads. La cassa ha bisogno solo dell'indirizzo di ricezione e lo verifica on-chain in configurazione.
Per chi è Wen Counter?
Per chiunque ne tragga aiuto: comunità cripto, eventi, negozi online per il proprio pubblico e qualsiasi negozio i cui acquirenti pagano già da un portafoglio Solana. Non è costruita per l'adozione di massa; è gratuita e aperta, quindi dove è utile, verrà usata.
E se un responsabile inserisce il proprio portafoglio?
Non può farlo senza il PIN delle impostazioni: portafogli e impostazioni sono bloccati sul dispositivo. Il proprietario imposta il PIN; quello predefinito della distribuzione (1111) va cambiato al primo avvio.
E se dimentichiamo il PIN?
Reinstalla l'app sul dispositivo, inserisci di nuovo i portafogli di ricezione e imposta un nuovo PIN. On-chain non cambia nulla; esporta il registro regolarmente così anche la cronologia locale è al sicuro.
Chi è responsabile quando la uso?
Tu. Noi diamo il meccanismo e non sappiamo come viene usato o modificato. Il meccanismo non prende, non detiene e non addebita nulla; segue le regole della rete, e il tuo portafoglio è tuo. Verifica la procedura di dichiarazione con il tuo commercialista.
Come faccio un rimborso?
Dall'app del tuo portafoglio, come nuovo pagamento all'acquirente. Premi ↩ accanto alla vendita nel registro: copia refund: più l'ID della transazione originale; incollalo nel memo così chiunque può abbinare rimborso e vendita.
La ricevuta è uno scontrino fiscale?
No. La cassa è un semplice strumento di aggregazione, non un registratore fiscale. Dà all'acquirente un QR della ricevuta, il testo della ricevuta o un NFT-ricevuta, tutti collegati alla transazione on-chain. Dove la legge richiede uno scontrino fiscale, emettilo come fai oggi.
Una cassa può servire più reparti o filiali?
Sì. Aggiungi nelle Impostazioni i portafogli 1..X con i loro nomi; alla cassa scegli dove va ogni vendita. Per le catene: un portafoglio di cassa per filiale, e gli incassi della giornata spostati ogni sera nel portafoglio centrale dell'azienda.
Il mio denaro o la mia chiave finiscono mai nella pagina?
No. La cassa conosce solo l'indirizzo pubblico di ricezione del negozio. Non chiede mai una frase seed o una chiave privata e non può spostare fondi.
La storia aperta: cos'è questa cassa
Wen non è solo un gatto che vaga nello spazio. Wen è un insieme di cose utili. Noi fissiamo soltanto l'idea e mostriamo il materiale e il meccanismo gratuiti più solidi per la vita reale: per il tempo e l'energia che le persone spendono al lavoro, con meno intermediari e con i costi cancellati là dove non sono mai stati necessari. È un piccolo segno che il mondo sta cambiando.
E il gatto è flessibile. Prendi tutto ciò che di aperto abbiamo raccolto: Solana, SPL Token, WEN, Token-2022, le build di prova, le istruzioni e le note del Wen Open Lab. Ora costruisci le tue soluzioni su misura per i tuoi compiti.
