add pinocchio transfer-tokens example (#596)

* add pinocchio transfer-tokens example

Add a Pinocchio implementation of tokens/transfer-tokens covering the
core SPL flow: create a mint, mint tokens to an associated token
account, and transfer tokens between wallets.

The program dispatches three instructions by a leading discriminator
byte (0=CreateToken, 1=MintTokens, 2=TransferTokens) using
pinocchio-token, pinocchio-associated-token-account, and
pinocchio-system. A bankrun test exercises the full create -> mint 150
-> transfer 50 flow and asserts the resulting 100/50 balances.

* fix pre-existing repo-wide biome errors

The whole-repo `biome check ./` (TypeScript CI job) was failing on three
files unrelated to this PR, which kept the check red:

- basics/cross-program-invocation/pinocchio/tests/test.ts: remove an unused
  discriminator constant and replace non-null assertions with explicit null
  guards
- tokens/token-swap/anchor/tests/deposit-liquidity.ts: apply the biome formatter
- tokens/token-2022/.../app/public/{next,vercel}.svg: add a <title> element
  (noSvgWithoutTitle)

---------

Co-authored-by: MarkFeder <5670736+MarkFeder@users.noreply.github.com>

Author: MarkFeder

Cargo.lock

@@ -51,6 +51,7 @@ members = [
     "basics/transfer-sol/asm",
 
     # tokens
+    "tokens/transfer-tokens/pinocchio/program",
     "tokens/token-2022/mint-close-authority/native/program",
     "tokens/token-2022/non-transferable/native/program",
     "tokens/token-2022/default-account-state/native/program",
@@ -87,6 +88,8 @@ pinocchio = { version = "0.10.2", features = ["cpi"] }
 pinocchio-log = "0.5.1"
 pinocchio-system = "0.5.0"
 pinocchio-pubkey = "0.3.0"
+pinocchio-token = "0.5.0"
+pinocchio-associated-token-account = "0.3.0"
 
 # testing
 litesvm = "0.11.0"

Cargo.toml

@@ -149,7 +149,7 @@ Create an NFT collection, mint NFTs, and verify NFTs as part of a collection usi
 
 [Transfer tokens between accounts](./tokens/transfer-tokens/README.md)
 
-[anchor](./tokens/transfer-tokens/anchor) [native](./tokens/transfer-tokens/native)
+[anchor](./tokens/transfer-tokens/anchor) [pinocchio](./tokens/transfer-tokens/pinocchio) [native](./tokens/transfer-tokens/native)
 
 ### Allowing users to swap digital assets - Escrow
 

README.md

@@ -17,9 +17,8 @@ describe("Pinocchio: CPI", async () => {
   const client = context.banksClient;
   const payer = context.payer;
 
-  // Lever instruction discriminators
+  // Lever instruction discriminator
   const IX_INITIALIZE = 0;
-  const IX_SWITCH_POWER = 1;
 
   const powerAccount = Keypair.generate();
 
@@ -43,8 +42,8 @@ describe("Pinocchio: CPI", async () => {
     await sendTx(ix, [powerAccount]);
 
     const acct = await client.getAccount(powerAccount.publicKey);
-    assert.isNotNull(acct);
-    assert.deepEqual(Buffer.from(acct!.data), Buffer.from([0])); // is_on = false
+    if (acct === null) throw new Error("power account not found");
+    assert.deepEqual(Buffer.from(acct.data), Buffer.from([0])); // is_on = false
   });
 
   it("Pull the lever!", async () => {
@@ -60,7 +59,8 @@ describe("Pinocchio: CPI", async () => {
     await sendTx(ix, []);
 
     const acct = await client.getAccount(powerAccount.publicKey);
-    assert.deepEqual(Buffer.from(acct!.data), Buffer.from([1])); // is_on = true
+    if (acct === null) throw new Error("power account not found");
+    assert.deepEqual(Buffer.from(acct.data), Buffer.from([1])); // is_on = true
   });
 
   it("Pull it again!", async () => {
@@ -76,7 +76,8 @@ describe("Pinocchio: CPI", async () => {
     await sendTx(ix, []);
 
     const acct = await client.getAccount(powerAccount.publicKey);
-    assert.deepEqual(Buffer.from(acct!.data), Buffer.from([0])); // is_on = false (flipped back)
+    if (acct === null) throw new Error("power account not found");
+    assert.deepEqual(Buffer.from(acct.data), Buffer.from([0])); // is_on = false (flipped back)
   });
 
   it("Lever rejects switch_power directly with no name", async () => {

basics/cross-program-invocation/pinocchio/tests/test.ts

@@ -72,7 +72,7 @@ describe("Deposit liquidity", () => {
     expect(depositTokenAccountB.value.amount).to.equal(values.defaultSupply.sub(values.depositAmountA).toString());
   });
 
-  it('Deposit with existing liquidity (same ratio)', async () => {
+  it("Deposit with existing liquidity (same ratio)", async () => {
     // 1. Initial Deposit
     await program.methods
       .depositLiquidity(values.depositAmountA, values.depositAmountA)
@@ -116,7 +116,7 @@ describe("Deposit liquidity", () => {
     expect(poolAccountA.value.amount).to.equal(values.depositAmountA.add(secondDepositAmount).toString());
   });
 
-  it('Deposit with different ratio', async () => {
+  it("Deposit with different ratio", async () => {
     // 1. Initial Deposit with 1:5 ratio
     // Pool A: 1,000,000
     // Pool B: 5,000,000
@@ -141,44 +141,44 @@ describe("Deposit liquidity", () => {
       .signers([values.admin])
       .rpc({ skipPreflight: true });
 
-        // 2. Second Deposit with mismatched input
-        // Input A: 500,000
-        // Input B: 500,000
-        // Logic:
-        // - 500k A requires 2.5M B. (User only provided 500k B).
-        // - 500k B requires 100k A. (User provided 500k A).
-        // Result: Deposit 100k A and 500k B.
-        const secondDepositA = new anchor.BN(500000);
-        const secondDepositBInput = new anchor.BN(500000);
-    
-        await program.methods
-          .depositLiquidity(secondDepositA, secondDepositBInput)
-          .accounts({
-            pool: values.poolKey,
-            poolAuthority: values.poolAuthority,
-            depositor: values.admin.publicKey,
-            mintLiquidity: values.mintLiquidity,
-            mintA: values.mintAKeypair.publicKey,
-            mintB: values.mintBKeypair.publicKey,
-            poolAccountA: values.poolAccountA,
-            poolAccountB: values.poolAccountB,
-            depositorAccountLiquidity: values.liquidityAccount,
-            depositorAccountA: values.holderAccountA,
-            depositorAccountB: values.holderAccountB,
-          })
-          .signers([values.admin])
-          .rpc({ skipPreflight: true });
-    
-        // 3. Verify Balances
-        const poolAccountA = await connection.getTokenAccountBalance(values.poolAccountA);
-        const poolAccountB = await connection.getTokenAccountBalance(values.poolAccountB);
-    
-        // Total A: 1,000,000 + 100,000 = 1,100,000
-        // We expect 100,000 A to be deposited.
-        const expectedAdditionalA = secondDepositBInput.mul(initialAmountA).div(initialAmountB); // 500k * (1M/5M) = 100k
-        expect(poolAccountA.value.amount).to.equal(initialAmountA.add(expectedAdditionalA).toString());
-        
-        // Total B: 5,000,000 + 500,000 = 5,500,000
-        expect(poolAccountB.value.amount).to.equal(initialAmountB.add(secondDepositBInput).toString());
-      });
-    });
+    // 2. Second Deposit with mismatched input
+    // Input A: 500,000
+    // Input B: 500,000
+    // Logic:
+    // - 500k A requires 2.5M B. (User only provided 500k B).
+    // - 500k B requires 100k A. (User provided 500k A).
+    // Result: Deposit 100k A and 500k B.
+    const secondDepositA = new anchor.BN(500000);
+    const secondDepositBInput = new anchor.BN(500000);
+
+    await program.methods
+      .depositLiquidity(secondDepositA, secondDepositBInput)
+      .accounts({
+        pool: values.poolKey,
+        poolAuthority: values.poolAuthority,
+        depositor: values.admin.publicKey,
+        mintLiquidity: values.mintLiquidity,
+        mintA: values.mintAKeypair.publicKey,
+        mintB: values.mintBKeypair.publicKey,
+        poolAccountA: values.poolAccountA,
+        poolAccountB: values.poolAccountB,
+        depositorAccountLiquidity: values.liquidityAccount,
+        depositorAccountA: values.holderAccountA,
+        depositorAccountB: values.holderAccountB,
+      })
+      .signers([values.admin])
+      .rpc({ skipPreflight: true });
+
+    // 3. Verify Balances
+    const poolAccountA = await connection.getTokenAccountBalance(values.poolAccountA);
+    const poolAccountB = await connection.getTokenAccountBalance(values.poolAccountB);
+
+    // Total A: 1,000,000 + 100,000 = 1,100,000
+    // We expect 100,000 A to be deposited.
+    const expectedAdditionalA = secondDepositBInput.mul(initialAmountA).div(initialAmountB); // 500k * (1M/5M) = 100k
+    expect(poolAccountA.value.amount).to.equal(initialAmountA.add(expectedAdditionalA).toString());
+
+    // Total B: 5,000,000 + 500,000 = 5,500,000
+    expect(poolAccountB.value.amount).to.equal(initialAmountB.add(secondDepositBInput).toString());
+  });
+});

tokens/token-2022/nft-meta-data-pointer/anchor-example/app/public/next.svg

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+# This script is for quick building & deploying of the program.
+# It also serves as a reference for the commands used for building & deploying Solana programs.
+# Run this bad boy with "bash cicd.sh" or "./cicd.sh"
+
+cargo build-sbf --manifest-path=./program/Cargo.toml --sbf-out-dir=./program/target/so
+solana program deploy ./program/target/so/program.so

tokens/token-2022/nft-meta-data-pointer/anchor-example/app/public/vercel.svg

@@ -0,0 +1,23 @@
+{
+  "type": "module",
+  "scripts": {
+    "test": "pnpm ts-mocha -p ./tsconfig.json -t 1000000 ./tests/test.ts",
+    "build-and-test": "cargo build-sbf --manifest-path=./program/Cargo.toml --sbf-out-dir=./tests/fixtures && pnpm test",
+    "build": "cargo build-sbf --manifest-path=./program/Cargo.toml --sbf-out-dir=./program/target/so",
+    "deploy": "solana program deploy ./program/target/so/program.so"
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.4",
+    "borsh": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/bn.js": "^5.1.0",
+    "@types/chai": "^4.3.1",
+    "@types/mocha": "^9.1.1",
+    "chai": "^4.3.4",
+    "mocha": "^9.0.3",
+    "solana-bankrun": "^0.3.0",
+    "ts-mocha": "^10.0.0",
+    "typescript": "^4.3.5"
+  }
+}