Add Insight API client for blockchain data access

Author: joaquim-verges

.changeset/quick-bugs-remain.md

@@ -0,0 +1,31 @@
+---
+"@thirdweb-dev/insight": major
+---
+
+Initial release of dedicated insight TS sdk
+
+This package is a thin openAPI wrapper for insight, our in-house indexer.
+
+## Configuration
+
+```ts
+import { configure } from "@thirdweb-dev/insight";
+
+// call this once at the startup of your application
+configure({
+  clientId: "<YOUR_CLIENT_ID>",
+});
+```
+
+## Example Usage
+
+```ts
+import { getV1Events } from "@thirdweb-dev/insight";
+
+const events = await getV1Events({
+  query: {
+    chain: [1, 137],
+    filter_address: "0x1234567890123456789012345678901234567890",
+  },
+});
+```

.changeset/wicked-pianos-carry.md

@@ -0,0 +1,45 @@
+---
+"thirdweb": minor
+---
+
+Expose getOwnedTokens, getOwnedNFTs and getTransaction functions
+
+You can now use Insight, our in-house indexer directly from the SDK with a simple API:
+
+## Get Owned ERC20 tokens
+
+```ts
+import { Insight } from "thirdweb";
+
+const tokens = await Insight.getOwnedTokens({
+  client,
+  ownerAddress,
+  chains: [base, polygon, arbitrum],
+});
+```
+
+## Get Owned NFTs (ERC721 and ERC1155)
+
+```ts
+import { Insight } from "thirdweb";
+
+const nfts = await Insight.getOwnedNFTs({
+  client,
+  ownerAddress,
+  chains: [sepolia],
+});
+```
+
+## Get Transactions for a given wallet address
+
+```ts
+import { Insight } from "thirdweb";
+
+const transactions = await Insight.getTransactions({
+  client,
+  walletAddress,
+  chains: [sepolia],
+});
+```
+
+All functions come with extra query filters for more granular queries, refer to the documentation for more details.

.github/workflows/CI.yml

@@ -123,7 +123,9 @@ jobs:
           mkdir test-project
           cd test-project
           npm init -y
-          ${{ matrix.package_manager }} add react react-dom ../packages/thirdweb
+          # Add workspace dependencies to package.json
+          npm pkg set dependencies.react=latest dependencies."react-dom"=latest dependencies.thirdweb="workspace:../packages/thirdweb" dependencies."@thirdweb-dev/insight"="workspace:../packages/insight"
+          ${{ matrix.package_manager }} install
       - name: Create test file
         run: |
           cd test-project
@@ -177,6 +179,9 @@ jobs:
       - name: Setup & Install
         uses: ./.github/composite-actions/install
 
+      - name: Build Packages
+        run: pnpm build
+
       - name: Report bundle size
         uses: andresz1/size-limit-action@94bc357df29c36c8f8d50ea497c3e225c3c95d1d # v1.8.0
         with:

apps/playground-web/src/components/pay/embed.tsx

@@ -9,7 +9,7 @@ import {
   defineChain,
   treasure,
 } from "thirdweb/chains";
-import { PayEmbed, getDefaultToken } from "thirdweb/react";
+import { PayEmbed } from "thirdweb/react";
 import { StyledConnectButton } from "../styled-connect-button";
 export function StyledPayEmbedPreview() {
   const { theme } = useTheme();
@@ -18,33 +18,6 @@ export function StyledPayEmbedPreview() {
     <div className="flex flex-col items-center justify-center">
       <StyledConnectButton
         chains={[base, defineChain(466), arbitrum, treasure, arbitrumNova]}
-        supportedTokens={{
-          466: [
-            {
-              address: "0x675C3ce7F43b00045a4Dab954AF36160fb57cB45",
-              name: "USDC",
-              symbol: "USDC",
-              icon: getDefaultToken(base, "USDC")?.icon,
-            },
-          ],
-          // biome-ignore lint/style/noNonNullAssertion: <explanation>
-          8453: [getDefaultToken(base, "USDC")!],
-          42161: [
-            {
-              address: "0x539bde0d7dbd336b79148aa742883198bbf60342",
-              name: "MAGIC",
-              symbol: "MAGIC",
-            },
-          ],
-          [arbitrumNova.id]: [
-            {
-              name: "Godcoin",
-              symbol: "GOD",
-              address: "0xb5130f4767ab0acc579f25a76e8f9e977cb3f948",
-              icon: "https://assets.coingecko.com/coins/images/53848/standard/GodcoinTickerIcon_02.png",
-            },
-          ],
-        }}
       />
       <div className="h-10" />
       <PayEmbed

apps/playground-web/src/components/styled-connect-button.tsx

@@ -30,9 +30,6 @@ export function StyledConnectButton(
         abstract,
       ]}
       wallets={WALLETS}
-      supportedNFTs={{
-        "84532": ["0x638263e3eAa3917a53630e61B1fBa685308024fa"],
-      }}
       client={THIRDWEB_CLIENT}
       theme={theme === "light" ? "light" : "dark"}
       {...props}

apps/portal/src/app/references/components/TDoc/utils/getSidebarLinkgroups.ts

@@ -44,6 +44,7 @@ const tagsToGroup = {
   "@client": "Client",
   "@account": "Account",
   "@nebula": "Nebula",
+  "@insight": "Insight",
 } as const;
 
 type TagKey = keyof typeof tagsToGroup;
@@ -61,6 +62,7 @@ const sidebarGroupOrder: TagKey[] = [
   "@account",
   "@contract",
   "@transaction",
+  "@insight",
   "@bridge",
   "@nebula",
   "@social",

packages/insight/README.md

@@ -0,0 +1,29 @@
+# Insight TypeScript SDK
+
+This package is a thin openAPI wrapper for insight, our in-house indexer.
+
+## Configuration
+
+```ts
+import { configure } from "@thirdweb-dev/insight";
+
+// call this once at the startup of your application
+configure({
+  clientId: "<YOUR_CLIENT_ID>",
+});
+```
+
+## Example Usage
+
+```ts
+import { getV1Events } from "@thirdweb-dev/insight";
+
+const events = await getV1Events({
+  query: {
+    chain: [1, 137],
+    filter_address: "0x1234567890123456789012345678901234567890",
+  },
+});
+```
+
+This package was autogenerated from the [Insight openAPI spec](https://insight-api.thirdweb.com/reference) using [@hey-api/openapi-ts](https://github.com/hey-api/openapi-ts)

packages/insight/biome.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.2/schema.json",
+  "extends": ["../../biome.json"],
+  "files": {
+    "ignore": ["src/client/**"]
+  }
+}

packages/insight/openapi-ts.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "@hey-api/openapi-ts";
+
+export default defineConfig({
+  input: "https://insight.thirdweb.com/openapi.json",
+  output: { path: "src/client" },
+  plugins: ["@hey-api/client-fetch"],
+});

packages/insight/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@thirdweb-dev/insight",
+  "version": "0.0.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thirdweb-dev/js.git#main"
+  },
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/thirdweb-dev/js/issues"
+  },
+  "author": "thirdweb eng <[email protected]>",
+  "type": "module",
+  "main": "./dist/cjs/exports/thirdweb.js",
+  "module": "./dist/esm/exports/thirdweb.js",
+  "types": "./dist/types/exports/thirdweb.d.ts",
+  "typings": "./dist/types/exports/thirdweb.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/exports/thirdweb.d.ts",
+      "import": "./dist/esm/exports/thirdweb.js",
+      "default": "./dist/cjs/exports/thirdweb.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist/*", "src/*"],
+  "dependencies": {
+    "@hey-api/client-fetch": "0.10.0",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@hey-api/openapi-ts": "0.66.1",
+    "rimraf": "6.0.1"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.4"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "format": "biome format ./src --write",
+    "lint": "biome check ./src",
+    "fix": "biome check ./src --fix",
+    "build": "pnpm clean && pnpm build:cjs && pnpm build:esm && pnpm build:types",
+    "build:cjs": "tsc --project ./tsconfig.build.json --module commonjs --outDir ./dist/cjs --verbatimModuleSyntax false && printf '{\"type\":\"commonjs\"}' > ./dist/cjs/package.json",
+    "build:esm": "tsc --project ./tsconfig.build.json --module es2020 --outDir ./dist/esm && printf '{\"type\": \"module\",\"sideEffects\":false}' > ./dist/esm/package.json",
+    "build:types": "tsc --project ./tsconfig.build.json --module esnext --declarationDir ./dist/types --emitDeclarationOnly --declaration --declarationMap",
+    "clean": "rimraf dist",
+    "build:generate": "openapi-ts && pnpm format"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}