feat: add gasless starter template

.github/workflows/test-examples.yml

@@ -108,7 +108,9 @@ jobs:
         run: |
           # Provides ephemeral-validator, query-filtering-service, vrf-oracle and
           # mb-test-validator — every binary test-locally.sh needs.
-          npm install -g @magicblock-labs/ephemeral-validator@latest
+          # Pinned: 1.1.1's committor sends transactions the base validator can't
+          # deserialize, so every commit-to-base test times out.
+          npm install -g @magicblock-labs/ephemeral-validator@0.14.10
 
       - name: Configure Solana
         env:

.gitignore

@@ -11,6 +11,7 @@
 **/.next/
 **/dist
 **/.env
+**/.vercel
 **/tsconfig.tsbuildinfo
 **/*test-storage
 

README.md

@@ -277,6 +277,17 @@ End-to-end app templates you can fork and build on.
 <p><em>MagicBlock VRF gachapon demo that mints a Metaplex Core NFT reward.</em></p>
 </blockquote>
 </td>
+<td valign="top" width="33%">
+<blockquote>
+<p><strong><a href="./gasless-starter/anchor/">⛽ Gasless Starter / Anchor</a></strong></p>
+<p>
+<img src="https://img.shields.io/badge/Anchor-5243AA?style=flat-square" alt="Anchor"/>
+<img src="https://img.shields.io/badge/Payments%20API-0ea5e9?style=flat-square" alt="Payments API"/>
+</p>
+<p><em>Make your program gasless: Payments API deposits and withdrawals, free ER transactions from a 0-SOL wallet. Tip jar example.</em></p>
+<p>🌐 <a href="https://gasless-starter.vercel.app">Live demo</a></p>
+</blockquote>
+</td>
 </tr>
 </table>
 
@@ -294,6 +305,7 @@ Deployed frontends for the examples that ship a UI.
 | [Binary Prediction / Anchor](./binary-prediction/anchor/) | https://binary-prediction.magicblock.app |
 | [Rewards (Delegated VRF) / Anchor](./rewards-delegated-vrf/anchor/) | https://magicblock-rewards-dashboard.vercel.app |
 | [Rock Paper Scissor / Anchor](./rock-paper-scissor/anchor/) | https://rps-example.magicblock.app |
+| [Gasless Starter / Anchor](./gasless-starter/anchor/) | https://gasless-starter.vercel.app |
 
 ## Testing
 
@@ -302,7 +314,7 @@ To run local tests for any example project, use the following steps:
 1. **Install Dependencies (Local nodes + example directory):**
 
    ```bash
-   npm install -g @magicblock-labs/ephemeral-validator@latest
+   npm install -g @magicblock-labs/ephemeral-validator@0.14.10
    cd <example-directory>
    yarn install
    ```

gasless-starter/anchor/Anchor.toml

@@ -0,0 +1,32 @@
+[toolchain]
+anchor_version = "1.0.2"
+
+[features]
+resolution = true
+skip-lint = false
+
+[programs.devnet]
+tip-jar = "DzY7Cgt6NJDSbM2QCjERGbnBSFvab1ZamxRWLatY8Gwm"
+
+[programs.localnet]
+tip-jar = "DzY7Cgt6NJDSbM2QCjERGbnBSFvab1ZamxRWLatY8Gwm"
+
+[registry]
+url = "https://api.apr.dev"
+
+[provider]
+cluster = "devnet"
+wallet = "~/.config/solana/id.json"
+
+[[test.genesis]]
+address = "SPLxh1LVZzEkX99H6rqYizhytLWPZVV296zyYDPagv2"
+program = "tests/fixtures/ephemeral_token_program.so"
+upgradeable = false
+
+[[test.genesis]]
+address = "DELeGGvXpWV2fqJUhqcF5ZSYMS4JTLjteaAMARRSaeSh"
+program = "tests/fixtures/dlp.so"
+upgradeable = false
+
+[scripts]
+test = "yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/tip-jar.ts"