Wen Open Lab · integrazione aperta

Fase 6: Devnet — ripetilo tu stessopronto da eseguire

English · Italiano · 中文 · 한국어

Tradotto dall’inglese da Wen insieme all’AI. Il riferimento è la pagina inglese; le correzioni sono benvenute.

Test di Wen sulla devnet di Solana
Testare in pubblico, non in teoria

Un test locale prova la logica; una rete pubblica la prova a tutti. La devnet è la rete di test aperta di Solana: gli stessi programmi della mainnet, ma le monete non hanno valore. Questa pagina è la ricetta ripetibile. Eseguila una volta, eseguila cento volte: ogni esecuzione crea nuovi indirizzi che chiunque può aprire nell'explorer.

Perché la devnet conta

Il registro delle verifiche mostra 41 verifiche superate dentro LiteSVM, una copia locale del runtime di Solana. È una prova forte, ma avviene su una sola macchina. Un'esecuzione su devnet porta gli stessi modelli su una rete pubblica dove ogni transazione ha un link pubblico. Nessuno deve fidarsi di noi: aprono il link e vedono la ricevuta con la sua offerta di uno, il pagamento della fattura con il suo memo, il pagamento rifiutato senza memo.

Cosa ti serve

  • Node.js 20 o successivo e i file di lab/code.
  • Gli strumenti a riga di comando di Solana (solana, solana-keygen).
  • Un portafoglio nuovo e vuoto creato solo per la devnet. Non usare mai un portafoglio che contiene fondi reali.

Ripetilo: cinque comandi

# 1. install the example project
npm install

# 2. create a throwaway devnet wallet (it never holds real money)
solana-keygen new -o devnet-wallet.json --no-bip39-passphrase

# 3. get free devnet SOL (test coins with no value; use faucet.solana.com if the CLI is rate-limited)
solana airdrop 2 $(solana-keygen pubkey devnet-wallet.json) --url devnet

# 4. run the local checks first
npm test

# 5. run the public devnet demo
KEYPAIR=./devnet-wallet.json npm run devnet

Lo script si rifiuta di funzionare su qualcosa che non sia la devnet, e si ferma se il portafoglio ha meno di 0,2 SOL di devnet.

Cosa fa lo script

  1. Modello 1: conia un NFT-ricevuta soulbound per un nuovo acquirente di prova, con l'hash dell'ordine e la data di garanzia dentro il mint, poi blocca l'offerta a uno.
  2. Modello 3: crea un token di regolamento con una commissione dello 0,25% con tetto a 50 unità e account congelati per impostazione predefinita, apre un account acquirente e uno venditore (il venditore richiede un memo di fattura), li approva entrambi, finanzia l'acquirente, paga la fattura INV-DEVNET-0001, poi tenta un pagamento senza numero di fattura e mostra che viene rifiutato.
  3. Stampa un link all'explorer per ogni transazione e ogni indirizzo.

File: lab/code/scripts/devnet-demo.ts · Apache-2.0

// Wen Open Lab: run Models 1 and 3 on PUBLIC DEVNET and print explorer links anyone can open.
// Devnet only. Use a NEW, EMPTY wallet created just for this. No real funds are ever needed.
// License: Apache-2.0. Example code, not audited.
//
//   solana-keygen new -o devnet-wallet.json          # new throwaway wallet
//   solana airdrop 2 $(solana-keygen pubkey devnet-wallet.json) --url devnet
//   KEYPAIR=./devnet-wallet.json npx tsx scripts/devnet-demo.ts
import { Keypair, LAMPORTS_PER_SOL, Transaction, sendAndConfirmTransaction, type TransactionInstruction } from '@solana/web3.js';
import { TOKEN_2022_PROGRAM_ID, createMintToInstruction } from '@solana/spl-token';
import { getConnection, loadKeypair } from '../src/common.js';
import { buildReceiptInstructions, receiptLayout, type Order } from '../src/01-receipt-nft.js';
import {
  buildApproveCounterparty, buildInvoiceAccount, buildPayInvoice, buildSettlementMint,
  invoiceAccountSpace, settlementMintSpace, DECIMALS,
} from '../src/03-b2b-invoice.js';

const connection = getConnection();
const wallet = loadKeypair();
const link = (kind: 'tx' | 'address', id: string) => `https://explorer.solana.com/${kind}/${id}?cluster=devnet`;

async function send(label: string, ixs: TransactionInstruction[], signers: Keypair[]) {
  const sig = await sendAndConfirmTransaction(connection, new Transaction().add(...ixs), signers);
  console.log(`  ${label}\n    ${link('tx', sig)}`);
  return sig;
}

async function main() {
  const endpoint = (connection as unknown as { rpcEndpoint: string }).rpcEndpoint;
  if (!/devnet/.test(endpoint)) throw new Error(`Refusing to run outside devnet: ${endpoint}`);
  const balance = await connection.getBalance(wallet.publicKey);
  console.log(`Wallet ${wallet.publicKey.toBase58()} has ${balance / LAMPORTS_PER_SOL} devnet SOL`);
  if (balance < 0.2 * LAMPORTS_PER_SOL) throw new Error('Need at least 0.2 devnet SOL: run `solana airdrop 2 <address> --url devnet`');

  // ---- Model 1: receipt NFT (soulbound) to a fresh "buyer" address ----
  console.log('\nModel 1 — receipt and warranty NFT');
  const buyer = Keypair.generate();
  const mint = Keypair.generate();
  const order: Order = { orderId: `DEVNET-${Date.now()}`, sku: 'WEN-PLUSH-01', priceMinorUnits: 2500, currency: 'USD', purchasedAt: new Date().toISOString(), warrantyMonths: 12 };
  const opts = { soulbound: true, uri: 'https://wen-watt.github.io/lab/receipt-warranty-wns.html' };
  const { rentSpace } = receiptLayout(order, mint.publicKey, wallet.publicKey, opts);
  const rent = await connection.getMinimumBalanceForRentExemption(rentSpace);
  const { instructions, buyerAta } = buildReceiptInstructions({ order, mint: mint.publicKey, merchant: wallet.publicKey, buyer: buyer.publicKey, opts, rentLamports: rent });
  await send('receipt minted, supply locked at 1', instructions, [wallet, mint]);
  console.log(`    receipt mint: ${link('address', mint.publicKey.toBase58())}`);
  console.log(`    buyer holds it in: ${link('address', buyerAta.toBase58())}`);

  // ---- Model 3: B2B settlement token with fee, allowlist and invoice memo ----
  console.log('\nModel 3 — B2B invoice settlement');
  const settle = Keypair.generate();
  await send('settlement mint created (fee 0.25% cap 50, frozen by default)',
    buildSettlementMint(wallet.publicKey, settle.publicKey, await connection.getMinimumBalanceForRentExemption(settlementMintSpace())), [wallet, settle]);
  const accRent = await connection.getMinimumBalanceForRentExemption(invoiceAccountSpace());
  const payerAcc = Keypair.generate(), sellerAcc = Keypair.generate();
  // In this demo one wallet plays both companies; in real life they are different owners.
  await send('buyer account opened', buildInvoiceAccount(wallet.publicKey, payerAcc.publicKey, settle.publicKey, accRent, false), [wallet, payerAcc]);
  await send('seller account opened (invoice memo required)', buildInvoiceAccount(wallet.publicKey, sellerAcc.publicKey, settle.publicKey, accRent, true), [wallet, sellerAcc]);
  await send('both companies approved by the issuer', [
    ...buildApproveCounterparty(wallet.publicKey, settle.publicKey, payerAcc.publicKey),
    ...buildApproveCounterparty(wallet.publicKey, settle.publicKey, sellerAcc.publicKey),
  ], [wallet]);
  const unit = 10n ** BigInt(DECIMALS);
  await send('buyer funded with 10,000 test units', [createMintToInstruction(settle.publicKey, payerAcc.publicKey, wallet.publicKey, 10_000n * unit, [], TOKEN_2022_PROGRAM_ID)], [wallet]);
  await send('invoice INV-DEVNET-0001 paid: 1,000 units, memo on-chain',
    buildPayInvoice({ mint: settle.publicKey, from: payerAcc.publicKey, to: sellerAcc.publicKey, payer: wallet.publicKey, invoiceId: 'INV-DEVNET-0001', amount: 1_000n * unit }), [wallet]);

  try {
    await send('payment WITHOUT invoice number (must fail)',
      buildPayInvoice({ mint: settle.publicKey, from: payerAcc.publicKey, to: sellerAcc.publicKey, payer: wallet.publicKey, invoiceId: null, amount: 1n * unit }), [wallet]);
    console.log('  !! unexpected: payment without memo succeeded');
  } catch {
    console.log('  payment WITHOUT invoice number was rejected, as designed');
  }
  console.log(`    settlement mint: ${link('address', settle.publicKey.toBase58())}`);
  console.log('\nDone. Paste these links into the Lab devnet page so anyone can inspect them.');
}

main().catch(e => { console.error(e); process.exit(1); });

Esecuzioni pubblicate

EsecuzioneDataMint della ricevutaMint di regolamentoPagamento della fattura
#1in attesa — la prima esecuzione pubblica sarà pubblicata qui con i suoi link all'explorer

L'hai eseguito tu? Condividi i tuoi link con la comunità su X (@wenwencoin). Le esecuzioni indipendenti sono la prova migliore che ci sia. L'intera esecuzione è raccontata in quattro lingue, italiano compreso: per gli sviluppatori su dev.to e per tutti su Hashnode.

Regole di sicurezza

  • Le monete della devnet non hanno valore e non si possono vendere. Chiunque si offra di «vendere» SOL di devnet è una truffa.
  • Tieni devnet-wallet.json fuori da qualsiasi repository e non riutilizzarlo mai sulla mainnet.
  • La devnet a volte viene azzerata o è lenta; se un passaggio fallisce, aspetta ed esegui di nuovo — ogni esecuzione riparte da zero.

Wen in immagini

Esecuzione devnet di Wen su Seeker
La tua esecuzione, la tua prova
Il gatto Wen controlla l'explorer
Ogni passaggio ha un link
Il costruttore Wen ripete il test
Ripetilo quando vuoi
Wen al telefono, link della devnet
Condividi i link
Sviluppatori Wen sulla devnet
I costruttori sono benvenuti

Dove si colloca Wen in questo modello

Il vero token WEN vive solo sulla mainnet; sulla devnet non c'è WEN. Lo script quindi crea i propri token di prova, chiaramente indicati come test. Quando un modello è pronto per WEN — per esempio la Fase 7, paga in WEN e ricevi USDC — passa alla mainnet solo dopo la sua esecuzione su devnet e una revisione indipendente.

Il filo di Wen: un contratto, ovunque

Ogni modello del Lab è gratuito e aperto, e ognuno porta la stessa firma: il contratto del token $WEN. Copialo, ripetilo nei tuoi documenti e verificalo sempre su un explorer prima di usarlo.

WENWENvqqNya429ubCdR81ZmD69brwQaaBYY6p3LCpk

Verifica: Solana Explorer · come trovare l'ID del contratto

Politica di uso aperto

  • Gratuito e aperto. Tutto il codice del Lab è rilasciato con licenza Apache 2.0, la stessa della Wen Program Library. Usalo, modificalo, distribuiscilo, a fini commerciali o no; mantieni l'avviso di licenza.
  • Solo strumenti aperti. Costruito su strumenti pubblici e documentati: Solana SPL Token-2022 (Token Extensions), il layout dei token del Wen New Standard (WNS), Solana Pay e LiteSVM per i test locali.
  • La regola: verifica sempre il tuo modello. Esegui i test, inizia sulla devnet, leggi la documentazione ufficiale, rivedi ogni account e importo e ottieni un audit indipendente prima di qualsiasi uso su mainnet. Un modello non verificato non è un modello, è un'ipotesi.
  • Non sottoposto ad audit, non è una consulenza. Questi sono esempi didattici. Non costituiscono consulenza finanziaria, legale o fiscale, né un prodotto di pagamento o bancario autorizzato. Pagamenti, stablecoin e acquiring sono attività regolamentate nella maggior parte dei paesi.
  • Sicurezza. Non incollare mai una chiave privata in un sito web. Non installare il pacchetto npm @wen-community/wen-new-standard: npm lo ha rimosso perché malevolo. Costruisci da fonti ufficiali.

Parla Wen, per la comunità. Altro nella nostra politica editoriale e sui dati.

Wen Open Lab · roadmap · tutto il codice · Wen Program Library su GitHub

Wen durante una passeggiata spaziale ripara lo scafo di una nave sopra la Terra, legato a una corda di sicurezza
Esercitati con una corda di sicurezza: solo devnet, un portafoglio nuovo e vuoto, una catena reale e rischio zero.