create-ponder 0.9.28 → 0.10.0

package/dist/index.js

@@ -16,7 +16,7 @@ import { default as prompts } from "prompts";
 // package.json
 var package_default = {
   name: "create-ponder",
-  version: "0.9.28",
+  version: "0.10.0",
   type: "module",
   description: "A CLI tool to create Ponder apps",
   license: "MIT",

package/package.json

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

package/templates/feature-api-functions/migrations/0000_equal_tarantula.sql

@@ -0,0 +1,6 @@
+CREATE SCHEMA "offchain";
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "offchain"."metadata" (
+	"id" serial PRIMARY KEY NOT NULL,
+	"account" "bytea" NOT NULL
+);

package/templates/feature-api-functions/migrations/0000_glamorous_fallen_one.sql

@@ -0,0 +1,6 @@
+CREATE SCHEMA "offchain";
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "offchain"."metadata" (
+	"id" serial PRIMARY KEY NOT NULL,
+	"account" text NOT NULL
+);

package/templates/feature-api-functions/migrations/meta/0000_snapshot.json

@@ -0,0 +1,40 @@
+{
+  "id": "6011cb22-cfd9-474d-a02b-ba6addfea155",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "offchain.metadata": {
+      "name": "metadata",
+      "schema": "offchain",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "serial",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "account": {
+          "name": "account",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {}
+    }
+  },
+  "enums": {},
+  "schemas": {
+    "offchain": "offchain"
+  },
+  "sequences": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

package/templates/feature-api-functions/migrations/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "postgresql",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "7",
+      "when": 1728509311024,
+      "tag": "0000_glamorous_fallen_one",
+      "breakpoints": true
+    }
+  ]
+}

package/templates/feature-api-functions/ponder.offchain.ts

@@ -0,0 +1,9 @@
+import { ponderHex } from "@ponder/core";
+import { pgSchema, serial } from "drizzle-orm/pg-core";
+
+export const offchainSchema = pgSchema("offchain");
+
+export const metadata = offchainSchema.table("metadata", {
+  id: serial("id").primaryKey(),
+  account: ponderHex("account").notNull(),
+});

package/templates/feature-api-functions/src/index.ts

@@ -31,7 +31,7 @@ ponder.on("ERC20:Transfer", async ({ event, context }) => {
 
   // add row to "transfer_event".
   await context.db.insert(transferEvent).values({
-    id: event.log.id,
+    id: event.id,
     amount: event.args.amount,
     timestamp: Number(event.block.timestamp),
     from: event.args.from,
@@ -54,7 +54,7 @@ ponder.on("ERC20:Approval", async ({ event, context }) => {
 
   // add row to "approval_event".
   await context.db.insert(approvalEvent).values({
-    id: event.log.id,
+    id: event.id,
     amount: event.args.amount,
     timestamp: Number(event.block.timestamp),
     owner: event.args.owner,

package/templates/feature-callTrace/_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/feature-callTrace/_dot_eslintrc.json

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

package/templates/feature-callTrace/_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/feature-callTrace/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "ponder-examples-feature-callTrace",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "ponder dev",
+    "start": "ponder start",
+    "codegen": "ponder codegen",
+    "serve": "ponder serve",
+    "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/feature-callTrace/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/feature-callTrace/ponder.config.ts

@@ -0,0 +1,22 @@
+import { createConfig } from "@ponder/core";
+import { http, Abi, multicall3Abi } from "viem";
+import { mainnet } from "viem/chains";
+
+export default createConfig({
+  networks: {
+    mainnet: {
+      chainId: 1,
+      transport: http(process.env.PONDER_RPC_URL_1),
+    },
+  },
+  contracts: {
+    multicall3: {
+      network: "mainnet",
+      abi: multicall3Abi,
+      address: mainnet.contracts.multicall3.address,
+      startBlock: 19_800_000,
+      includeFunctionCalls: true,
+      maxBlockRange: 25,
+    },
+  },
+});

package/templates/feature-callTrace/ponder.schema.ts

@@ -0,0 +1,11 @@
+import { createSchema } from "@ponder/core";
+
+export default createSchema((p) => ({
+  multicalls: p.createTable({
+    id: p.hex(),
+    gasUsed: p.bigint(),
+    bytes: p.int(),
+    successfulCalls: p.int(),
+    failedCalls: p.int(),
+  }),
+}));

package/templates/feature-callTrace/src/index.ts

@@ -0,0 +1,33 @@
+import { ponder } from "@/generated";
+
+ponder.on("multicall3.aggregate3()", async ({ event, context }) => {
+  await context.db.multicalls.upsert({
+    id: event.trace.from,
+    create: {
+      gasUsed: event.trace.gasUsed,
+      bytes: event.args[0].reduce<number>(
+        (acc, cur) => acc + Math.ceil((cur.callData.length - 2) / 8),
+        0,
+      ),
+      successfulCalls: event.result.filter(({ success }) => success === true)
+        .length,
+      failedCalls: event.result.filter(({ success }) => success === false)
+        .length,
+    },
+    update: ({ current }) => ({
+      gasUsed: current.gasUsed + event.trace.gasUsed,
+      bytes:
+        current.bytes +
+        event.args[0].reduce<number>(
+          (acc, cur) => acc + Math.ceil((cur.callData.length - 2) / 8),
+          0,
+        ),
+      successfulCalls:
+        current.successfulCalls +
+        event.result.filter(({ success }) => success === true).length,
+      failedCalls:
+        current.failedCalls +
+        event.result.filter(({ success }) => success === false).length,
+    }),
+  });
+});

package/templates/feature-callTrace/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/feature-factory/abis/ChildContractAbi.ts

@@ -0,0 +1,62 @@
+export const ChildContractAbi = [
+  {
+    inputs: [
+      { internalType: "string", name: "_name", type: "string" },
+      { internalType: "uint256", name: "_initialValue", type: "uint256" },
+    ],
+    stateMutability: "nonpayable",
+    type: "constructor",
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "child",
+        type: "address",
+      },
+      {
+        indexed: true,
+        internalType: "address",
+        name: "updater",
+        type: "address",
+      },
+      {
+        indexed: false,
+        internalType: "uint256",
+        name: "oldValue",
+        type: "uint256",
+      },
+      {
+        indexed: false,
+        internalType: "uint256",
+        name: "newValue",
+        type: "uint256",
+      },
+    ],
+    name: "ValueUpdated",
+    type: "event",
+  },
+  {
+    inputs: [],
+    name: "factory",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "_newValue", type: "uint256" }],
+    name: "setValue",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "value",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;

package/templates/feature-factory/src/index.ts

@@ -0,0 +1,24 @@
+import { ponder } from "ponder:registry";
+import { childContract } from "../ponder.schema";
+
+ponder.on("LlamaCore:ActionCreated", async ({ event }) => {
+  console.log(
+    `Handling ActionCreated event from LlamaCore @ ${event.log.address}`,
+  );
+});
+
+ponder.on("LlamaPolicy:Initialized", async ({ event }) => {
+  console.log(
+    `Handling Initialized event from LlamaPolicy @ ${event.log.address}`,
+  );
+});
+
+ponder.on("ChildContract:ValueUpdated", async ({ event, context }) => {
+  const { child, updater, oldValue, newValue } = event.args;
+  context.db.insert(childContract).values({
+    id: child,
+  });
+  console.log(
+    `Handling ValueUpdated event from ChildContract @ ${event.log.address}`,
+  );
+});

package/templates/feature-filter/src/index.ts

@@ -3,7 +3,7 @@ import schema from "ponder:schema";
 
 ponder.on("PrimitiveManager:Swap", async ({ event, context }) => {
   await context.db.insert(schema.swapEvent).values({
-    id: event.log.id,
+    id: event.id,
     payer: event.args.payer,
     recipient: event.args.recipient,
   });

package/templates/feature-proxy/src/index.ts

@@ -4,11 +4,11 @@ import schema from "ponder:schema";
 ponder.on("AstariaRouter:Liquidation", async ({ event, context }) => {
   await context.db
     .insert(schema.liquidationEvent)
-    .values({ id: event.log.id, liquidator: event.args.liquidator });
+    .values({ id: event.id, liquidator: event.args.liquidator });
 });
 
 ponder.on("AstariaRouter:OwnershipTransferred", async ({ event, context }) => {
   await context.db
     .insert(schema.ownershipTransferEvent)
-    .values({ id: event.log.id, newOwner: event.args.newOwner });
+    .values({ id: event.id, newOwner: event.args.newOwner });
 });

package/templates/project-friendtech/src/FriendtechSharesV1.ts

@@ -14,7 +14,7 @@ ponder.on("FriendtechSharesV1:Trade", async ({ event, context }) => {
     : event.args.ethAmount - feeAmount;
 
   const tradeEvent = await context.db.insert(schema.tradeEvent).values({
-    id: event.log.id,
+    id: event.id,
     subject: event.args.subject,
     trader: event.args.trader,
     shareAmount: event.args.shareAmount,

package/templates/project-uniswap-v3-flash/ponder.config.ts

@@ -1,15 +1,11 @@
 import { createConfig, factory } from "ponder";
 import { http, getAbiItem } from "viem";
-
 import { UniswapV3FactoryAbi } from "./abis/UniswapV3FactoryAbi";
 import { UniswapV3PoolAbi } from "./abis/UniswapV3PoolAbi";
 
 export default createConfig({
   networks: {
-    mainnet: {
-      chainId: 1,
-      transport: http(process.env.PONDER_RPC_URL_1),
-    },
+    mainnet: { chainId: 1, transport: http(process.env.PONDER_RPC_URL_1) },
   },
   contracts: {
     UniswapV3Pool: {
@@ -21,9 +17,6 @@ export default createConfig({
         parameter: "pool",
       }),
       startBlock: 12369621,
-      filter: {
-        event: "Flash",
-      },
     },
   },
 });

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

@@ -38,7 +38,7 @@ ponder.on("ERC1155:TransferSingle", async ({ event, context }) => {
 
   // Create a TransferEvent.
   await context.db.insert(schema.transferEvent).values({
-    id: event.log.id,
+    id: event.id,
     from: event.args.from,
     to: event.args.to,
     token: event.args.id,
@@ -83,7 +83,7 @@ ponder.on("ERC1155:TransferBatch", async ({ event, context }) => {
       }));
 
     await context.db.insert(schema.transferEvent).values({
-      id: event.log.id,
+      id: event.id,
       from: event.args.from,
       to: event.args.to,
       token: id,

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

@@ -23,7 +23,7 @@ ponder.on("ERC20:Transfer", async ({ event, context }) => {
 
   // add row to "transfer_event".
   await context.db.insert(transferEvent).values({
-    id: event.log.id,
+    id: event.id,
     amount: event.args.amount,
     timestamp: Number(event.block.timestamp),
     from: event.args.from,
@@ -44,7 +44,7 @@ ponder.on("ERC20:Approval", async ({ event, context }) => {
 
   // add row to "approval_event".
   await context.db.insert(approvalEvent).values({
-    id: event.log.id,
+    id: event.id,
     amount: event.args.amount,
     timestamp: Number(event.block.timestamp),
     owner: event.args.owner,

package/templates/reference-erc20/src/indexing/index.ts

@@ -0,0 +1,70 @@
+import { ponder } from "@/generated";
+
+ponder.on("ERC20:Transfer", async ({ event, context }) => {
+  const { Account, TransferEvent } = context.db;
+
+  // Create an Account for the sender, or update the balance if it already exists.
+  await Account.upsert({
+    id: event.args.from,
+    create: {
+      balance: BigInt(0),
+      isOwner: false,
+    },
+    update: ({ current }) => ({
+      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,
+    create: {
+      balance: event.args.amount,
+      isOwner: false,
+    },
+    update: ({ current }) => ({
+      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,
+      amount: event.args.amount,
+      timestamp: Number(event.block.timestamp),
+    },
+  });
+});
+
+ponder.on("ERC20:Approval", async ({ event, context }) => {
+  const { Allowance, ApprovalEvent } = context.db;
+
+  const allowanceId = `${event.args.owner}-${event.args.spender}`;
+
+  // Create or update the Allowance.
+  await Allowance.upsert({
+    id: allowanceId,
+    create: {
+      ownerId: event.args.owner,
+      spenderId: event.args.spender,
+      amount: event.args.amount,
+    },
+    update: {
+      amount: event.args.amount,
+    },
+  });
+
+  // Create an ApprovalEvent.
+  await ApprovalEvent.create({
+    id: event.log.id,
+    data: {
+      ownerId: event.args.owner,
+      spenderId: event.args.spender,
+      amount: event.args.amount,
+      timestamp: Number(event.block.timestamp),
+    },
+  });
+});

package/templates/reference-erc20/src/server/index.ts

@@ -0,0 +1,20 @@
+import { ponder } from "@/generated";
+import { graphql } from "@ponder/core";
+
+ponder.use("/graphql", graphql());
+
+ponder.get("/router", async (c) => {
+  const db = c.get("db");
+
+  // await db.query(`UPDATE "Account" SET "isOwner" = 1`);
+
+  const account = await db.query<{ balance: bigint }>(
+    `SELECT * FROM "Account" LIMIT 1`,
+  );
+
+  if (account.rows.length === 0) {
+    return c.text("Not Found!");
+  } else {
+    return c.text(`Balance: ${account.rows[0]!.balance.toString()}`);
+  }
+});

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

@@ -20,7 +20,7 @@ ponder.on("ERC4626:Transfer", async ({ event, context }) => {
 
   // Create a TransferEvent.
   await context.db.insert(schema.transferEvent).values({
-    id: event.log.id,
+    id: event.id,
     from: event.args.from,
     to: event.args.to,
     amount: event.args.amount,
@@ -41,7 +41,7 @@ ponder.on("ERC4626:Approval", async ({ event, context }) => {
 
   // Create an ApprovalEvent.
   await context.db.insert(schema.approvalEvent).values({
-    id: event.log.id,
+    id: event.id,
     owner: event.args.owner,
     spender: event.args.spender,
     amount: event.args.amount,
@@ -51,7 +51,7 @@ ponder.on("ERC4626:Approval", async ({ event, context }) => {
 
 ponder.on("ERC4626:Deposit", async ({ event, context }) => {
   await context.db.insert(schema.depositEvent).values({
-    id: event.log.id,
+    id: event.id,
     sender: event.args.caller,
     receiver: event.args.owner,
     assets: event.args.assets,
@@ -61,7 +61,7 @@ ponder.on("ERC4626:Deposit", async ({ event, context }) => {
 
 ponder.on("ERC4626:Withdraw", async ({ event, context }) => {
   await context.db.insert(schema.withdrawalEvent).values({
-    id: event.log.id,
+    id: event.id,
     sender: event.args.caller,
     owner: event.args.owner,
     receiver: event.args.receiver,

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

@@ -24,7 +24,7 @@ ponder.on("ERC721:Transfer", async ({ event, context }) => {
 
   // Create a TransferEvent.
   await context.db.insert(schema.transferEvent).values({
-    id: event.log.id,
+    id: event.id,
     from: event.args.from,
     to: event.args.to,
     token: event.args.id,