create-ponder 0.4.40 → 0.5.0-next.2

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ponder",
-  "version": "0.4.40",
+  "version": "0.5.0-next.2",
   "type": "module",
   "description": "A CLI tool to create Ponder apps",
   "license": "MIT",

package/templates/empty/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/etherscan/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/feature-blocks/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/feature-call-traces/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

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/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/feature-filter/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/feature-multichain/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/feature-proxy/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/feature-read-contract/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/project-friendtech/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/project-uniswap-v3-flash/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

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

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/reference-erc20/package.json

@@ -12,6 +12,7 @@
   },
   "dependencies": {
     "@ponder/core": "workspace:*",
+    "hono": "^4.4.6",
     "viem": "^1.19.9"
   },
   "devDependencies": {

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

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";
@@ -25,3 +25,23 @@ declare module "@/generated" {
     Virtual.IndexingFunctionArgs<config, schema, name>;
   export type Schema = Virtual.Schema<schema>;
 }
+
+declare module "ponder:db" {
+  import type { ConvertToDrizzleTable } from "@ponder/core";
+
+  type schema = typeof import("./ponder.schema.ts").default;
+
+  const drizzleTables: {
+    [tableName in keyof schema]: ConvertToDrizzleTable<
+      tableName,
+      schema[tableName]["table"],
+      schema
+    >;
+  };
+
+  export = drizzleTables;
+}
+
+declare module "ponder:db" {
+  export * from "@ponder/core/drizzle";
+}

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

@@ -0,0 +1,26 @@
+import { Allowance, asc, desc, sql } from "ponder:db";
+import { ponder } from "@/generated";
+import { graphql, replaceBigInts } from "@ponder/core";
+
+// write file
+ponder.use("/graphql", graphql());
+
+ponder.get("/allowance", async (c) => {
+  const db = c.get("db");
+
+  const result = await db
+    .select({
+      owner: Allowance.ownerId,
+      count: sql<number>`cast(count(${Allowance.id}) as int)`,
+      balance: sql<number>`cast(sum(${Allowance.amount}) as numeric(78,0))`,
+    })
+    .from(Allowance)
+    .groupBy(Allowance.ownerId)
+    .orderBy(desc(sql`count`))
+    .limit(2);
+
+  // Hono JSON doesn't support BigInts
+  const safeResult = replaceBigInts(result, (b) => b.toString());
+
+  return c.json(safeResult);
+});

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/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

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

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type { Virtual } from "@ponder/core";

package/templates/subgraph/ponder-env.d.ts

@@ -1,7 +1,7 @@
 // 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.
+// See https://ponder.sh/docs/getting-started/installation#typescript for more information.
 
 declare module "@/generated" {
   import type {