create-ponder 0.2.8 → 0.2.9

package/dist/index.js

@@ -16,7 +16,7 @@ import { default as prompts } from "prompts";
 // package.json
 var package_default = {
   name: "create-ponder",
-  version: "0.2.8",
+  version: "0.2.9",
   type: "module",
   description: "A CLI tool to create Ponder apps",
   license: "MIT",
@@ -652,6 +652,16 @@ var templates = [
     id: "reference-erc721",
     title: "Reference - ERC721",
     description: "A Ponder app for an ERC721 token"
+  },
+  {
+    id: "reference-erc1155",
+    title: "Reference - ERC1155",
+    description: "A Ponder app for an ERC1155 token"
+  },
+  {
+    id: "reference-erc4626",
+    title: "Reference - ERC4626",
+    description: "A Ponder app for an ERC4626 token"
   }
 ];
 async function run({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ponder",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "type": "module",
   "description": "A CLI tool to create Ponder apps",
   "license": "MIT",

package/templates/feature-multichain/_dot_env.local

@@ -4,6 +4,9 @@ PONDER_RPC_URL_1=
 # Optimism RPC URL used for fetching blockchain data. Alchemy is recommended.
 PONDER_RPC_URL_10=https://opt-mainnet.g.alchemy.com/v2/...
 
+# Polygon RPC URL used for fetching blockchain data. Alchemy is recommended.
+PONDER_RPC_URL_137=https://polygon-mainnet.g.alchemy.com/v2/...
+
 # Base RPC URL used for fetching blockchain data. Alchemy is recommended.
 PONDER_RPC_URL_8453=https://base-mainnet.g.alchemy.com/v2/...
 

package/templates/feature-multichain/ponder.config.ts

@@ -15,24 +15,38 @@ const latestBlockOptimism = await createPublicClient({
 const latestBlockArbitrum = await createPublicClient({
   transport: http(process.env.PONDER_RPC_URL_42161),
 }).getBlock();
+const latestBlockPolygon = await createPublicClient({
+  transport: http(process.env.PONDER_RPC_URL_137),
+}).getBlock();
+
+console.log(latestBlockPolygon.number);
 
 export default createConfig({
   networks: {
     mainnet: {
       chainId: 1,
       transport: http(process.env.PONDER_RPC_URL_1),
+      pollingInterval: 15_000,
     },
     base: {
       chainId: 8453,
       transport: http(process.env.PONDER_RPC_URL_8453),
+      pollingInterval: 15_000,
     },
     optimism: {
       chainId: 10,
       transport: http(process.env.PONDER_RPC_URL_10),
+      pollingInterval: 15_000,
     },
     arbitrum: {
       chainId: 42161,
       transport: http(process.env.PONDER_RPC_URL_42161),
+      pollingInterval: 15_000,
+    },
+    polygon: {
+      chainId: 137,
+      transport: http(process.env.PONDER_RPC_URL_137),
+      pollingInterval: 15_000,
     },
   },
   contracts: {
@@ -54,6 +68,10 @@ export default createConfig({
           address: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
           startBlock: Number(latestBlockArbitrum.number) - 50,
         },
+        polygon: {
+          address: "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
+          startBlock: Number(latestBlockPolygon.number) - 200,
+        },
       },
     },
   },

package/templates/reference-erc1155/README.md

@@ -0,0 +1,24 @@
+# Example ERC1155 token API
+
+This example shows how to create a GraphQL API for an ERC1155 token using Ponder. It uses the Curio Cards Tokens contract on Ethereum ([Link](https://etherscan.io/address/0x73da73ef3a6982109c4d5bdb0db9dd3e3783f313)).
+
+## Sample query
+
+### Get the current owner and all transfer events for a token
+
+```graphql
+{
+  token(id: "7") {
+    account {
+      id
+    }
+    transferEvents {
+      items {
+        fromId
+        toId
+        timestamp
+      }
+    }
+  }
+}
+```

package/templates/reference-erc1155/_dot_env.local

@@ -0,0 +1,5 @@
+# Mainnet RPC URL used for fetching blockchain data. Alchemy is recommended.
+PONDER_RPC_URL_1=
+
+# (Optional) Postgres database URL. If not provided, SQLite will be used. 
+DATABASE_URL=

package/templates/reference-erc1155/_dot_eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "ponder"
+}

package/templates/reference-erc1155/_dot_gitignore

@@ -0,0 +1,18 @@
+# Dependencies
+/node_modules
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Misc
+.DS_Store
+
+# Env files
+.env*.local
+
+# Ponder
+/generated/
+/.ponder/

package/templates/reference-erc1155/abis/erc1155Abi.ts

@@ -0,0 +1,162 @@
+export const erc1155ABI = [
+  {
+    stateMutability: "view",
+    type: "function",
+    inputs: [
+      { name: "", internalType: "address", type: "address" },
+      { name: "", internalType: "uint256", type: "uint256" },
+    ],
+    name: "balanceOf",
+    outputs: [{ name: "", internalType: "uint256", type: "uint256" }],
+  },
+  {
+    stateMutability: "view",
+    type: "function",
+    inputs: [
+      { name: "owners", internalType: "address[]", type: "address[]" },
+      { name: "ids", internalType: "uint256[]", type: "uint256[]" },
+    ],
+    name: "balanceOfBatch",
+    outputs: [
+      { name: "balances", internalType: "uint256[]", type: "uint256[]" },
+    ],
+  },
+  {
+    stateMutability: "view",
+    type: "function",
+    inputs: [
+      { name: "", internalType: "address", type: "address" },
+      { name: "", internalType: "address", type: "address" },
+    ],
+    name: "isApprovedForAll",
+    outputs: [{ name: "", internalType: "bool", type: "bool" }],
+  },
+  {
+    stateMutability: "nonpayable",
+    type: "function",
+    inputs: [
+      { name: "from", internalType: "address", type: "address" },
+      { name: "to", internalType: "address", type: "address" },
+      { name: "ids", internalType: "uint256[]", type: "uint256[]" },
+      { name: "amounts", internalType: "uint256[]", type: "uint256[]" },
+      { name: "data", internalType: "bytes", type: "bytes" },
+    ],
+    name: "safeBatchTransferFrom",
+    outputs: [],
+  },
+  {
+    stateMutability: "nonpayable",
+    type: "function",
+    inputs: [
+      { name: "from", internalType: "address", type: "address" },
+      { name: "to", internalType: "address", type: "address" },
+      { name: "id", internalType: "uint256", type: "uint256" },
+      { name: "amount", internalType: "uint256", type: "uint256" },
+      { name: "data", internalType: "bytes", type: "bytes" },
+    ],
+    name: "safeTransferFrom",
+    outputs: [],
+  },
+  {
+    stateMutability: "nonpayable",
+    type: "function",
+    inputs: [
+      { name: "operator", internalType: "address", type: "address" },
+      { name: "approved", internalType: "bool", type: "bool" },
+    ],
+    name: "setApprovalForAll",
+    outputs: [],
+  },
+  {
+    stateMutability: "view",
+    type: "function",
+    inputs: [{ name: "interfaceId", internalType: "bytes4", type: "bytes4" }],
+    name: "supportsInterface",
+    outputs: [{ name: "", internalType: "bool", type: "bool" }],
+  },
+  {
+    stateMutability: "view",
+    type: "function",
+    inputs: [{ name: "id", internalType: "uint256", type: "uint256" }],
+    name: "uri",
+    outputs: [{ name: "", internalType: "string", type: "string" }],
+  },
+  {
+    type: "event",
+    anonymous: false,
+    inputs: [
+      {
+        name: "owner",
+        internalType: "address",
+        type: "address",
+        indexed: true,
+      },
+      {
+        name: "operator",
+        internalType: "address",
+        type: "address",
+        indexed: true,
+      },
+      { name: "approved", internalType: "bool", type: "bool", indexed: false },
+    ],
+    name: "ApprovalForAll",
+  },
+  {
+    type: "event",
+    anonymous: false,
+    inputs: [
+      {
+        name: "operator",
+        internalType: "address",
+        type: "address",
+        indexed: true,
+      },
+      { name: "from", internalType: "address", type: "address", indexed: true },
+      { name: "to", internalType: "address", type: "address", indexed: true },
+      {
+        name: "ids",
+        internalType: "uint256[]",
+        type: "uint256[]",
+        indexed: false,
+      },
+      {
+        name: "amounts",
+        internalType: "uint256[]",
+        type: "uint256[]",
+        indexed: false,
+      },
+    ],
+    name: "TransferBatch",
+  },
+  {
+    type: "event",
+    anonymous: false,
+    inputs: [
+      {
+        name: "operator",
+        internalType: "address",
+        type: "address",
+        indexed: true,
+      },
+      { name: "from", internalType: "address", type: "address", indexed: true },
+      { name: "to", internalType: "address", type: "address", indexed: true },
+      { name: "id", internalType: "uint256", type: "uint256", indexed: false },
+      {
+        name: "amount",
+        internalType: "uint256",
+        type: "uint256",
+        indexed: false,
+      },
+    ],
+    name: "TransferSingle",
+  },
+  {
+    type: "event",
+    anonymous: false,
+    inputs: [
+      { name: "value", internalType: "string", type: "string", indexed: false },
+      { name: "id", internalType: "uint256", type: "uint256", indexed: true },
+    ],
+    name: "URI",
+  },
+] as const;

package/templates/reference-erc1155/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "ponder-examples-reference-erc1155",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "ponder dev",
+    "start": "ponder start",
+    "codegen": "ponder codegen",
+    "lint": "eslint .",
+    "typecheck": "tsc"
+  },
+  "dependencies": {
+    "@ponder/core": "workspace:*",
+    "viem": "^1.19.9"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "eslint": "^8.54.0",
+    "eslint-config-ponder": "workspace:*",
+    "typescript": "^5.3.2"
+  },
+  "engines": {
+    "node": ">=18.14"
+  }
+}

package/templates/reference-erc1155/ponder-env.d.ts

@@ -0,0 +1,27 @@
+// This file enables type checking and editor autocomplete for this Ponder project.
+// After upgrading, you may find that changes have been made to this file.
+// If this happens, please commit the changes. Do not manually edit this file.
+// See https://ponder.sh/docs/guides/typescript for more information.
+
+declare module "@/generated" {
+  import type { Virtual } from "@ponder/core";
+
+  type config = typeof import("./ponder.config.ts").default;
+  type schema = typeof import("./ponder.schema.ts").default;
+
+  export const ponder: Virtual.Registry<config, schema>;
+
+  export type EventNames = Virtual.EventNames<config>;
+  export type Event<name extends EventNames = EventNames> = Virtual.Event<
+    config,
+    name
+  >;
+  export type Context<name extends EventNames = EventNames> = Virtual.Context<
+    config,
+    schema,
+    name
+  >;
+  export type IndexingFunctionArgs<name extends EventNames = EventNames> =
+    Virtual.IndexingFunctionArgs<config, schema, name>;
+  export type Schema = Virtual.Schema<schema>;
+}

package/templates/reference-erc1155/ponder.config.ts

@@ -0,0 +1,20 @@
+import { createConfig } from "@ponder/core";
+import { http } from "viem";
+import { erc1155ABI } from "./abis/erc1155Abi";
+
+export default createConfig({
+  networks: {
+    mainnet: {
+      chainId: 1,
+      transport: http(process.env.PONDER_RPC_URL_1),
+    },
+  },
+  contracts: {
+    ERC1155: {
+      network: "mainnet",
+      abi: erc1155ABI,
+      address: "0x73da73ef3a6982109c4d5bdb0db9dd3e3783f313",
+      startBlock: 12129118,
+    },
+  },
+});

package/templates/reference-erc1155/ponder.schema.ts

@@ -0,0 +1,29 @@
+import { createSchema } from "@ponder/core";
+
+export default createSchema((p) => ({
+  Account: p.createTable({
+    id: p.hex(),
+    tokens: p.many("TokenBalance.ownerId"),
+
+    transferFromEvents: p.many("TransferEvent.fromId"),
+    transferToEvents: p.many("TransferEvent.toId"),
+  }),
+  TokenBalance: p.createTable({
+    id: p.string(),
+    tokenId: p.bigint(),
+    balance: p.bigint(),
+
+    ownerId: p.hex().references("Account.id"),
+    owner: p.one("ownerId"),
+  }),
+  TransferEvent: p.createTable({
+    id: p.string(),
+    timestamp: p.int(),
+    fromId: p.hex().references("Account.id"),
+    toId: p.hex().references("Account.id"),
+    tokenId: p.bigint(),
+
+    from: p.one("fromId"),
+    to: p.one("toId"),
+  }),
+}));

package/templates/reference-erc1155/src/index.ts

@@ -0,0 +1,109 @@
+import { ponder } from "@/generated";
+
+ponder.on("ERC1155:TransferSingle", async ({ event, context }) => {
+  const { Account, TokenBalance, TransferEvent } = context.db;
+
+  // Create an Account for the sender, or update the balance if it already exists.
+  await Account.upsert({
+    id: event.args.from,
+  });
+
+  await TokenBalance.upsert({
+    id: `${event.args.id}-${event.args.from}`,
+    create: {
+      tokenId: event.args.id,
+      ownerId: event.args.from,
+      balance: -event.args.amount,
+    },
+    update: ({ current }) => ({
+      tokenId: event.args.id,
+      ownerId: event.args.from,
+      balance: current.balance - event.args.amount,
+    }),
+  });
+
+  // Create an Account for the recipient, or update the balance if it already exists.
+  await Account.upsert({
+    id: event.args.to,
+  });
+
+  await TokenBalance.upsert({
+    id: `${event.args.id}-${event.args.to}`,
+    create: {
+      tokenId: event.args.id,
+      ownerId: event.args.to,
+      balance: event.args.amount,
+    },
+    update: ({ current }) => ({
+      tokenId: event.args.id,
+      ownerId: event.args.to,
+      balance: current.balance + event.args.amount,
+    }),
+  });
+
+  // Create a TransferEvent.
+  await TransferEvent.create({
+    id: event.log.id,
+    data: {
+      fromId: event.args.from,
+      toId: event.args.to,
+      tokenId: event.args.id,
+      timestamp: Number(event.block.timestamp),
+    },
+  });
+});
+
+ponder.on("ERC1155:TransferBatch", async ({ event, context }) => {
+  const { Account, TokenBalance, TransferEvent } = context.db;
+
+  await Account.upsert({
+    id: event.args.from,
+  });
+
+  await Account.upsert({
+    id: event.args.to,
+  });
+
+  for (let i = 0; i < event.args.ids.length; i++) {
+    const id = event.args.ids[i]!;
+    const amount = event.args.amounts[i]!;
+
+    await TokenBalance.upsert({
+      id: `${id}-${event.args.from}`,
+      create: {
+        tokenId: id,
+        ownerId: event.args.from,
+        balance: -amount,
+      },
+      update: ({ current }) => ({
+        tokenId: id,
+        ownerId: event.args.from,
+        balance: current.balance - amount,
+      }),
+    });
+
+    await TokenBalance.upsert({
+      id: `${id}-${event.args.to}`,
+      create: {
+        tokenId: id,
+        ownerId: event.args.to,
+        balance: amount,
+      },
+      update: ({ current }) => ({
+        tokenId: id,
+        ownerId: event.args.to,
+        balance: current.balance + amount,
+      }),
+    });
+
+    await TransferEvent.create({
+      id: `${event.log.id}-${i}`,
+      data: {
+        fromId: event.args.from,
+        toId: event.args.to,
+        tokenId: id,
+        timestamp: Number(event.block.timestamp),
+      },
+    });
+  }
+});

package/templates/reference-erc1155/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    // Type checking
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+
+    // Interop constraints
+    "verbatimModuleSyntax": false,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+
+    // Language and environment
+    "moduleResolution": "bundler",
+    "module": "ESNext",
+    "noEmit": true,
+    "lib": ["ES2022"],
+    "target": "ES2022",
+
+    // Skip type checking for node modules
+    "skipLibCheck": true
+  },
+  "include": ["./**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/reference-erc20/README.md

@@ -1,6 +1,6 @@
 # Example ERC20 token API
 
-This example shows how to create a GraphQL API for an ERC20 token using Ponder. It uses the Adventure Gold token contract.
+This example shows how to create a GraphQL API for an ERC20 token using Ponder. It uses the Adventure Gold token contract on Ethereum ([Link](https://etherscan.io/address/0x32353A6C91143bfd6C7d363B546e62a9A2489A20)).
 
 ## Sample queries