@coinbase/cdp-sdk 1.1.2 → 1.3.0

package/openapi-client/generated/solana-accounts/solana-accounts.msw.ts

@@ -0,0 +1,219 @@
+/**
+ * Generated by orval v7.6.0 🍺
+ * Do not edit manually.
+ * Coinbase Developer Platform APIs
+ * The Coinbase Developer Platform APIs - leading the world's transition onchain.
+ * OpenAPI spec version: 2.0.0
+ */
+import { faker } from "@faker-js/faker";
+
+import { HttpResponse, delay, http } from "msw";
+
+import type {
+  ListSolanaAccounts200,
+  SignSolanaMessage200,
+  SignSolanaTransaction200,
+  SolanaAccount,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+export const getListSolanaAccountsResponseMock = (): ListSolanaAccounts200 => ({
+  ...{
+    accounts: Array.from({ length: faker.number.int({ min: 1, max: 10 }) }, (_, i) => i + 1).map(
+      () => ({
+        address: faker.helpers.fromRegExp("^[1-9A-HJ-NP-Za-km-z]{32,44}$"),
+        name: faker.helpers.arrayElement([
+          faker.helpers.fromRegExp("^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$"),
+          undefined,
+        ]),
+      }),
+    ),
+  },
+  ...{ nextPageToken: faker.helpers.arrayElement([faker.string.alpha(20), undefined]) },
+});
+
+export const getCreateSolanaAccountResponseMock = (
+  overrideResponse: Partial<SolanaAccount> = {},
+): SolanaAccount => ({
+  address: faker.helpers.fromRegExp("^[1-9A-HJ-NP-Za-km-z]{32,44}$"),
+  name: faker.helpers.arrayElement([
+    faker.helpers.fromRegExp("^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$"),
+    undefined,
+  ]),
+  ...overrideResponse,
+});
+
+export const getGetSolanaAccountResponseMock = (
+  overrideResponse: Partial<SolanaAccount> = {},
+): SolanaAccount => ({
+  address: faker.helpers.fromRegExp("^[1-9A-HJ-NP-Za-km-z]{32,44}$"),
+  name: faker.helpers.arrayElement([
+    faker.helpers.fromRegExp("^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$"),
+    undefined,
+  ]),
+  ...overrideResponse,
+});
+
+export const getGetSolanaAccountByNameResponseMock = (
+  overrideResponse: Partial<SolanaAccount> = {},
+): SolanaAccount => ({
+  address: faker.helpers.fromRegExp("^[1-9A-HJ-NP-Za-km-z]{32,44}$"),
+  name: faker.helpers.arrayElement([
+    faker.helpers.fromRegExp("^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$"),
+    undefined,
+  ]),
+  ...overrideResponse,
+});
+
+export const getSignSolanaTransactionResponseMock = (
+  overrideResponse: Partial<SignSolanaTransaction200> = {},
+): SignSolanaTransaction200 => ({ signedTransaction: faker.string.alpha(20), ...overrideResponse });
+
+export const getSignSolanaMessageResponseMock = (
+  overrideResponse: Partial<SignSolanaMessage200> = {},
+): SignSolanaMessage200 => ({ signature: faker.string.alpha(20), ...overrideResponse });
+
+export const getListSolanaAccountsMockHandler = (
+  overrideResponse?:
+    | ListSolanaAccounts200
+    | ((
+        info: Parameters<Parameters<typeof http.get>[1]>[0],
+      ) => Promise<ListSolanaAccounts200> | ListSolanaAccounts200),
+) => {
+  return http.get("*/v2/solana/accounts", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getListSolanaAccountsResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
+export const getCreateSolanaAccountMockHandler = (
+  overrideResponse?:
+    | SolanaAccount
+    | ((
+        info: Parameters<Parameters<typeof http.post>[1]>[0],
+      ) => Promise<SolanaAccount> | SolanaAccount),
+) => {
+  return http.post("*/v2/solana/accounts", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getCreateSolanaAccountResponseMock(),
+      ),
+      { status: 201, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
+export const getGetSolanaAccountMockHandler = (
+  overrideResponse?:
+    | SolanaAccount
+    | ((
+        info: Parameters<Parameters<typeof http.get>[1]>[0],
+      ) => Promise<SolanaAccount> | SolanaAccount),
+) => {
+  return http.get("*/v2/solana/accounts/:address", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getGetSolanaAccountResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
+export const getGetSolanaAccountByNameMockHandler = (
+  overrideResponse?:
+    | SolanaAccount
+    | ((
+        info: Parameters<Parameters<typeof http.get>[1]>[0],
+      ) => Promise<SolanaAccount> | SolanaAccount),
+) => {
+  return http.get("*/v2/solana/accounts/by-name/:name", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getGetSolanaAccountByNameResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
+export const getSignSolanaTransactionMockHandler = (
+  overrideResponse?:
+    | SignSolanaTransaction200
+    | ((
+        info: Parameters<Parameters<typeof http.post>[1]>[0],
+      ) => Promise<SignSolanaTransaction200> | SignSolanaTransaction200),
+) => {
+  return http.post("*/v2/solana/accounts/:address/sign/transaction", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getSignSolanaTransactionResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
+export const getSignSolanaMessageMockHandler = (
+  overrideResponse?:
+    | SignSolanaMessage200
+    | ((
+        info: Parameters<Parameters<typeof http.post>[1]>[0],
+      ) => Promise<SignSolanaMessage200> | SignSolanaMessage200),
+) => {
+  return http.post("*/v2/solana/accounts/:address/sign/message", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getSignSolanaMessageResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+export const getSolanaAccountsMock = () => [
+  getListSolanaAccountsMockHandler(),
+  getCreateSolanaAccountMockHandler(),
+  getGetSolanaAccountMockHandler(),
+  getGetSolanaAccountByNameMockHandler(),
+  getSignSolanaTransactionMockHandler(),
+  getSignSolanaMessageMockHandler(),
+];

package/openapi-client/generated/solana-accounts/solana-accounts.ts

@@ -0,0 +1,143 @@
+/**
+ * Generated by orval v7.6.0 🍺
+ * Do not edit manually.
+ * Coinbase Developer Platform APIs
+ * The Coinbase Developer Platform APIs - leading the world's transition onchain.
+ * OpenAPI spec version: 2.0.0
+ */
+import type {
+  CreateSolanaAccountBody,
+  ListSolanaAccounts200,
+  ListSolanaAccountsParams,
+  SignSolanaMessage200,
+  SignSolanaMessageBody,
+  SignSolanaTransaction200,
+  SignSolanaTransactionBody,
+  SolanaAccount,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+import { cdpApiClient } from "../../cdpApiClient.js";
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+/**
+ * Lists the Solana accounts belonging to the developer.
+The response is paginated, and by default, returns 20 accounts per page.
+
+If a name is provided, the response will contain only the account with that name.
+ * @summary List Solana accounts or get account by name
+ */
+export const listSolanaAccounts = (
+  params?: ListSolanaAccountsParams,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<ListSolanaAccounts200>(
+    { url: `/v2/solana/accounts`, method: "GET", params },
+    options,
+  );
+};
+/**
+ * Creates a new Solana account.
+ * @summary Create a Solana account
+ */
+export const createSolanaAccount = (
+  createSolanaAccountBody?: CreateSolanaAccountBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<SolanaAccount>(
+    {
+      url: `/v2/solana/accounts`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: createSolanaAccountBody,
+    },
+    options,
+  );
+};
+/**
+ * Gets a Solana account by its address.
+ * @summary Get a Solana account by address
+ */
+export const getSolanaAccount = (
+  address: string,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<SolanaAccount>(
+    { url: `/v2/solana/accounts/${address}`, method: "GET" },
+    options,
+  );
+};
+/**
+ * Gets a Solana account by its name.
+ * @summary Get a Solana account by name
+ */
+export const getSolanaAccountByName = (
+  name: string,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<SolanaAccount>(
+    { url: `/v2/solana/accounts/by-name/${name}`, method: "GET" },
+    options,
+  );
+};
+/**
+ * Signs a transaction with the given Solana account.
+The unsigned transaction should be serialized into a byte array and then encoded as base64.
+
+**Transaction types**
+
+The following transaction types are supported:
+* [Legacy transactions](https://solana-labs.github.io/solana-web3.js/classes/Transaction.html)
+* [Versioned transactions](https://solana-labs.github.io/solana-web3.js/classes/VersionedTransaction.html)
+
+The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.
+ * @summary Sign a transaction
+ */
+export const signSolanaTransaction = (
+  address: string,
+  signSolanaTransactionBody: SignSolanaTransactionBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<SignSolanaTransaction200>(
+    {
+      url: `/v2/solana/accounts/${address}/sign/transaction`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: signSolanaTransactionBody,
+    },
+    options,
+  );
+};
+/**
+ * Signs an arbitrary message with the given Solana account.
+
+**WARNING:** Never sign a message that you didn't generate, as it can be an arbitrary transaction. For example, it might send all of your funds to an attacker.
+ * @summary Sign a message
+ */
+export const signSolanaMessage = (
+  address: string,
+  signSolanaMessageBody: SignSolanaMessageBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<SignSolanaMessage200>(
+    {
+      url: `/v2/solana/accounts/${address}/sign/message`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: signSolanaMessageBody,
+    },
+    options,
+  );
+};
+export type ListSolanaAccountsResult = NonNullable<Awaited<ReturnType<typeof listSolanaAccounts>>>;
+export type CreateSolanaAccountResult = NonNullable<
+  Awaited<ReturnType<typeof createSolanaAccount>>
+>;
+export type GetSolanaAccountResult = NonNullable<Awaited<ReturnType<typeof getSolanaAccount>>>;
+export type GetSolanaAccountByNameResult = NonNullable<
+  Awaited<ReturnType<typeof getSolanaAccountByName>>
+>;
+export type SignSolanaTransactionResult = NonNullable<
+  Awaited<ReturnType<typeof signSolanaTransaction>>
+>;
+export type SignSolanaMessageResult = NonNullable<Awaited<ReturnType<typeof signSolanaMessage>>>;

package/openapi-client/index.ts

@@ -0,0 +1,36 @@
+export * from "./generated/coinbaseDeveloperPlatformAPIs.schemas.js";
+export * from "./generated/evm-accounts/evm-accounts.js";
+export * from "./generated/evm-smart-accounts/evm-smart-accounts.js";
+export * from "./generated/evm-token-balances/evm-token-balances.js";
+export * from "./generated/solana-accounts/solana-accounts.js";
+export * from "./generated/faucets/faucets.js";
+
+import { configure } from "./cdpApiClient.js";
+import * as evm from "./generated/evm-accounts/evm-accounts.js";
+import * as evmSmartAccounts from "./generated/evm-smart-accounts/evm-smart-accounts.js";
+import * as evmTokenBalances from "./generated/evm-token-balances/evm-token-balances.js";
+import * as faucets from "./generated/faucets/faucets.js";
+import * as solana from "./generated/solana-accounts/solana-accounts.js";
+
+export const CdpOpenApiClient = {
+  ...evm,
+  ...evmSmartAccounts,
+  ...evmTokenBalances,
+  ...solana,
+  ...faucets,
+  configure,
+};
+
+export const OpenApiEvmMethods = {
+  ...evm,
+  ...evmSmartAccounts,
+  ...evmTokenBalances,
+  requestEvmFaucet: faucets.requestEvmFaucet,
+};
+
+export const OpenApiSolanaMethods = {
+  ...solana,
+  requestSolanaFaucet: faucets.requestSolanaFaucet,
+};
+
+export type CdpOpenApiClientType = typeof CdpOpenApiClient;

package/package.json

@@ -1,12 +1,37 @@
 {
   "name": "@coinbase/cdp-sdk",
-  "version": "1.1.2",
-  "description": "CDP SDK",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "1.3.0",
+  "description": "SDK for interacting with the Coinbase Developer Platform Wallet API",
+  "main": "./_cjs/index.js",
+  "module": "./_esm/index.js",
+  "types": "./_types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./_types/index.d.ts",
+      "import": "./_esm/index.js",
+      "default": "./_cjs/index.js"
+    },
+    "./auth": {
+      "types": "./_types/auth/index.d.ts",
+      "import": "./_esm/auth/index.js",
+      "default": "./_cjs/auth/index.js"
+    }
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.1",
+    "abitype": "1.0.6",
+    "axios": "^1.8.2",
+    "jose": "^6.0.8",
+    "md5": "^2.3.0",
+    "viem": "^2.21.26"
+  },
+  "author": "Coinbase Inc.",
   "repository": "https://github.com/coinbase/cdp-sdk",
+  "license": "MIT",
   "files": [
-    "dist"
+    "*",
+    "!**/*.test.ts",
+    "!examples"
   ],
   "keywords": [
     "coinbase",
@@ -15,65 +40,5 @@
     "cdp sdk",
     "sdk",
     "api"
-  ],
-  "author": "Coinbase Inc.",
-  "license": "MIT",
-  "dependencies": {
-    "@solana/web3.js": "^1.98.0",
-    "abitype": "1.0.6",
-    "axios": "^1.8.2",
-    "jose": "^6.0.8",
-    "md5": "^2.3.0",
-    "viem": "^2.21.26"
-  },
-  "devDependencies": {
-    "@changesets/changelog-github": "^0.5.1",
-    "@changesets/cli": "^2.28.1",
-    "@faker-js/faker": "^9.6.0",
-    "@types/node": "^20.12.11",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "@vitest/coverage-v8": "^1.4.0",
-    "bs58": "^6.0.0",
-    "dotenv": "^16.4.7",
-    "eslint": "^8.57.1",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-jsdoc": "^48.11.0",
-    "eslint-plugin-prettier": "^5.2.5",
-    "msw": "^2.7.3",
-    "orval": "^7.6.0",
-    "prettier": "^3.2.5",
-    "tsx": "^4.19.3",
-    "typedoc": "^0.27.2",
-    "typescript": "^5.4.5",
-    "uuid": "^11.1.0",
-    "vitest": "^1.4.0"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./auth": {
-      "types": "./dist/auth/index.d.ts",
-      "default": "./dist/auth/index.js"
-    }
-  },
-  "scripts": {
-    "changeset": "changeset",
-    "changeset:version": "changeset version",
-    "lint": "eslint -c .eslintrc.json \"src/**/*.ts\"",
-    "lint:fix": "eslint -c .eslintrc.json \"src/**/*.ts\" --fix",
-    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
-    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
-    "test": "vitest --config=./vitest.config.ts run",
-    "test:watch": "vitest --config=./vitest.config.ts",
-    "test:coverage": "vitest --config=./vitest.config.ts run --coverage",
-    "test:e2e": "pnpm build && vitest --config=./vitest.e2e.config.ts run",
-    "test:e2e:watch": "vitest --config=./vitest.e2e.config.ts",
-    "clean": "rm -rf dist/*",
-    "build": "tsc",
-    "docs": "typedoc --entryPoints ./src --entryPointStrategy expand --exclude ./src/tests/**/*.ts",
-    "orval": "make -C .. check-openapi || echo \" NOTE: THERE IS A NEW OPENAPI FILE AVAILABLE. RUN 'make update-openapi' IN THE ROOT DIRECTORY TO UPDATE IT.\"; orval --config orval.config.ts"
-  }
+  ]
 }

package/types/calls.ts

@@ -0,0 +1,40 @@
+/* eslint-disable */
+// Adapted from viem (https://github.com/wevm/viem)
+
+import type { AbiStateMutability, Address } from "viem";
+import type { GetMulticallContractParameters } from "./multicall.js";
+import type { OneOf, Prettify } from "./utils.js";
+import type { Hex } from "./misc.js";
+
+export type Call<call = unknown, extraProperties extends Record<string, unknown> = {}> = OneOf<
+  | (extraProperties & {
+      data?: Hex | undefined;
+      to: Address;
+      value?: bigint | undefined;
+    })
+  | (extraProperties &
+      (Omit<GetMulticallContractParameters<call, AbiStateMutability>, "address"> & {
+        to: Address;
+        value?: bigint | undefined;
+      }))
+>;
+
+export type Calls<
+  calls extends readonly unknown[],
+  extraProperties extends Record<string, unknown> = {},
+  ///
+  result extends readonly any[] = [],
+> = calls extends readonly [] // no calls, return empty
+  ? readonly []
+  : calls extends readonly [infer call] // one call left before returning `result`
+    ? readonly [...result, Prettify<Call<call, extraProperties>>]
+    : calls extends readonly [infer call, ...infer rest] // grab first call and recurse through `rest`
+      ? Calls<[...rest], extraProperties, [...result, Prettify<Call<call, extraProperties>>]>
+      : readonly unknown[] extends calls
+        ? calls
+        : // If `calls` is *some* array but we couldn't assign `unknown[]` to it, then it must hold some known/homogenous type!
+          // use this to infer the param types in the case of Array.map() argument
+          calls extends readonly (infer call extends OneOf<Call>)[]
+          ? readonly Prettify<call>[]
+          : // Fallback
+            readonly OneOf<Call>[];

package/types/contract.ts

@@ -0,0 +1,126 @@
+/* eslint-disable */
+// Adapted from viem (https://github.com/wevm/viem)
+
+import type {
+  Abi,
+  AbiFunction,
+  AbiParametersToPrimitiveTypes,
+  AbiStateMutability,
+  Address,
+  ExtractAbiFunction,
+  ExtractAbiFunctionNames,
+  ResolvedRegister,
+} from "abitype";
+
+import type { Hex } from "./misc.js";
+import type { IsUnion, UnionToTuple } from "./utils.js";
+
+export type ContractFunctionName<
+  abi extends Abi | readonly unknown[] = Abi,
+  mutability extends AbiStateMutability = AbiStateMutability,
+> =
+  ExtractAbiFunctionNames<
+    abi extends Abi ? abi : Abi,
+    mutability
+  > extends infer functionName extends string
+    ? [functionName] extends [never]
+      ? string
+      : functionName
+    : string;
+
+export type ContractFunctionArgs<
+  abi extends Abi | readonly unknown[] = Abi,
+  mutability extends AbiStateMutability = AbiStateMutability,
+  functionName extends ContractFunctionName<abi, mutability> = ContractFunctionName<
+    abi,
+    mutability
+  >,
+> =
+  AbiParametersToPrimitiveTypes<
+    ExtractAbiFunction<abi extends Abi ? abi : Abi, functionName, mutability>["inputs"],
+    "inputs"
+  > extends infer args
+    ? [args] extends [never]
+      ? readonly unknown[]
+      : args
+    : readonly unknown[];
+
+export type Widen<type> =
+  | ([unknown] extends [type] ? unknown : never)
+  | (type extends Function ? type : never)
+  | (type extends ResolvedRegister["BigIntType"] ? bigint : never)
+  | (type extends boolean ? boolean : never)
+  | (type extends ResolvedRegister["IntType"] ? number : never)
+  | (type extends string
+      ? type extends ResolvedRegister["AddressType"]
+        ? ResolvedRegister["AddressType"]
+        : type extends ResolvedRegister["BytesType"]["inputs"]
+          ? ResolvedRegister["BytesType"]
+          : string
+      : never)
+  | (type extends readonly [] ? readonly [] : never)
+  | (type extends Record<string, unknown> ? { [K in keyof type]: Widen<type[K]> } : never)
+  | (type extends { length: number }
+      ? {
+          [K in keyof type]: Widen<type[K]>;
+        } extends infer Val extends readonly unknown[]
+        ? readonly [...Val]
+        : never
+      : never);
+
+export type UnionWiden<type> = type extends any ? Widen<type> : never;
+
+export type ExtractAbiFunctionForArgs<
+  abi extends Abi,
+  mutability extends AbiStateMutability,
+  functionName extends ContractFunctionName<abi, mutability>,
+  args extends ContractFunctionArgs<abi, mutability, functionName>,
+> =
+  ExtractAbiFunction<abi, functionName, mutability> extends infer abiFunction extends AbiFunction
+    ? IsUnion<abiFunction> extends true // narrow overloads using `args` by converting to tuple and filtering out overloads that don't match
+      ? UnionToTuple<abiFunction> extends infer abiFunctions extends readonly AbiFunction[]
+        ? // convert back to union (removes `never` tuple entries)
+          { [k in keyof abiFunctions]: CheckArgs<abiFunctions[k], args> }[number]
+        : never
+      : abiFunction
+    : never;
+type CheckArgs<
+  abiFunction extends AbiFunction,
+  args,
+  ///
+  targetArgs extends AbiParametersToPrimitiveTypes<
+    abiFunction["inputs"],
+    "inputs"
+  > = AbiParametersToPrimitiveTypes<abiFunction["inputs"], "inputs">,
+> = (readonly [] extends args ? readonly [] : args) extends targetArgs // fallback to `readonly []` if `args` has no value (e.g. `args` property not provided)
+  ? abiFunction
+  : never;
+
+export type ContractFunctionParameters<
+  abi extends Abi | readonly unknown[] = Abi,
+  mutability extends AbiStateMutability = AbiStateMutability,
+  functionName extends ContractFunctionName<abi, mutability> = ContractFunctionName<
+    abi,
+    mutability
+  >,
+  args extends ContractFunctionArgs<abi, mutability, functionName> = ContractFunctionArgs<
+    abi,
+    mutability,
+    functionName
+  >,
+  deployless extends boolean = false,
+  ///
+  allFunctionNames = ContractFunctionName<abi, mutability>,
+  allArgs = ContractFunctionArgs<abi, mutability, functionName>,
+  /*
+   * when `args` is inferred to `readonly []` ("inputs": []) or `never` (`abi` declared as `Abi` or not inferrable), allow `args` to be optional.
+   * important that both branches return same structural type
+   */
+> = {
+  abi: abi;
+  functionName:
+    | allFunctionNames // show all options
+    | (functionName extends allFunctionNames ? functionName : never); // infer value
+  args?: (abi extends Abi ? UnionWiden<args> : never) | allArgs | undefined;
+} & (readonly [] extends allArgs ? {} : { args: Widen<args> }) &
+  (deployless extends true ? { address?: undefined; code: Hex } : { address: Address });