@hub3js/starknet 0.0.0-experimental-29a36fc0-20260720

package/dist/actions.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderAPI } from './types.js';
+export declare const recommended: (readonly ["disconnect", typeof import("@hub3js/std/actions").disconnect])[];
+export declare function canEagerConnect(instance: () => ProviderAPI): () => Promise<any>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,eAAO,MAAM,WAAW,8EAA0B,CAAC;AAEnD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,WAAW,sBAY1D"}

package/dist/after.d.ts

@@ -0,0 +1,2 @@
+export declare const recommended: (readonly ["connect", typeof import("@hub3js/std/operators").intoConnectionFinished])[];
+//# sourceMappingURL=after.d.ts.map

package/dist/after.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"after.d.ts","sourceRoot":"","sources":["../src/after.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,yFAAwB,CAAC"}

package/dist/and.d.ts

@@ -0,0 +1,3 @@
+import { connectAndUpdateStateForSingleNetwork } from '@hub3js/std/operators';
+export declare const recommended: (readonly ["connect", typeof connectAndUpdateStateForSingleNetwork])[];
+//# sourceMappingURL=and.d.ts.map

package/dist/and.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"and.d.ts","sourceRoot":"","sources":["../src/and.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,uBAAuB,CAAC;AAE9E,eAAO,MAAM,WAAW,wEAEvB,CAAC"}

package/dist/before.d.ts

@@ -0,0 +1,2 @@
+export declare const recommended: (readonly ["connect", typeof import("@hub3js/std/operators").intoConnecting])[];
+//# sourceMappingURL=before.d.ts.map

package/dist/before.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"before.d.ts","sourceRoot":"","sources":["../src/before.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,iFAAyB,CAAC"}

package/dist/builders.d.ts

@@ -0,0 +1,5 @@
+import type { StarknetActions } from './types.js';
+import { ActionBuilder } from '@hub3js/core';
+export declare const connect: () => ActionBuilder<StarknetActions, "connect">;
+export declare const canEagerConnect: () => ActionBuilder<StarknetActions, "canEagerConnect">;
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQ7C,eAAO,MAAM,OAAO,iDAIc,CAAC;AAEnC,eAAO,MAAM,eAAe,yDAC8C,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const CAIP_NAMESPACE = "starknet";
+export declare const CAIP_STARKNET_CHAIN_ID = "SN_MAIN";
+export declare const CHAIN_ID = "SOLANA";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAChD,eAAO,MAAM,QAAQ,WAAW,CAAC"}

package/dist/mod.d.ts

@@ -0,0 +1,9 @@
+export * as actions from './actions.js';
+export * as after from './after.js';
+export * as and from './and.js';
+export * as before from './before.js';
+export * as builders from './builders.js';
+export * as utils from './utils.js';
+export type { ProviderAPI, StarknetActions } from './types.js';
+export { CAIP_NAMESPACE, CAIP_STARKNET_CHAIN_ID } from './constants.js';
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mod.js

@@ -0,0 +1,2 @@
+var a=Object.defineProperty;var e=(o,t)=>a(o,"name",{value:t,configurable:!0});var n=(o,t)=>{for(var r in t)a(o,r,{get:t[r],enumerable:!0})};var i={};n(i,{canEagerConnect:()=>x,recommended:()=>P});import{recommendedActions as C}from"@hub3js/std/actions";var P=[...C];function x(o){return async()=>{let t=o();if(!t)throw new Error("Trying to eagerly connect to your Starknet wallet, but seems its instance is not available.");return t.isPreauthorized()}}e(x,"canEagerConnect");var m={};n(m,{recommended:()=>y});import{afterRecommended as S}from"@hub3js/std/operators";var y=[...S];var p={};n(p,{recommended:()=>_});import{connectAndUpdateStateForSingleNetwork as N}from"@hub3js/std/operators";var _=[["connect",N]];var A={};n(A,{recommended:()=>E});import{beforeRecommended as g}from"@hub3js/std/operators";var E=[...g];var f={};n(f,{canEagerConnect:()=>T,connect:()=>w});import{ActionBuilder as d}from"@hub3js/core";import{connectAndUpdateStateForSingleNetwork as l,intoConnecting as k,intoConnectionFinished as b}from"@hub3js/std/operators";var w=e(()=>new d("connect").and(l).before(k).after(b),"connect"),T=e(()=>new d("canEagerConnect"),"canEagerConnect");var u={};n(u,{formatAccountsToCAIP:()=>j,getAccounts:()=>R});import{AccountId as h}from"caip";var c="starknet",s="SN_MAIN",I="SOLANA";async function R(o){let t=await o.connect();return{accounts:[t?t.publicKey.toString():o.publicKey.toString()],chainId:I}}e(R,"getAccounts");function j(o){return o.map(t=>h.format({address:t.toString(),chainId:{namespace:c,reference:s}}))}e(j,"formatAccountsToCAIP");export{c as CAIP_NAMESPACE,s as CAIP_STARKNET_CHAIN_ID,i as actions,m as after,p as and,A as before,f as builders,u as utils};
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/actions.ts", "../src/after.ts", "../src/and.ts", "../src/before.ts", "../src/builders.ts", "../src/utils.ts", "../src/constants.ts"],
+  "sourcesContent": ["import type { ProviderAPI } from './types.js';\n\nimport { recommendedActions } from '@hub3js/std/actions';\n\nexport const recommended = [...recommendedActions];\n\nexport function canEagerConnect(instance: () => ProviderAPI) {\n  return async () => {\n    const starknetInstance = instance();\n\n    if (!starknetInstance) {\n      throw new Error(\n        'Trying to eagerly connect to your Starknet wallet, but seems its instance is not available.',\n      );\n    }\n\n    return starknetInstance.isPreauthorized();\n  };\n}\n", "import { afterRecommended } from '@hub3js/std/operators';\n\nexport const recommended = [...afterRecommended];\n", "import { connectAndUpdateStateForSingleNetwork } from '@hub3js/std/operators';\n\nexport const recommended = [\n  ['connect', connectAndUpdateStateForSingleNetwork] as const,\n];\n", "import { beforeRecommended } from '@hub3js/std/operators';\n\nexport const recommended = [...beforeRecommended];\n", "import type { StarknetActions } from './types.js';\n\nimport { ActionBuilder } from '@hub3js/core';\nimport {\n  connectAndUpdateStateForSingleNetwork,\n  intoConnecting,\n  intoConnectionFinished,\n} from '@hub3js/std/operators';\n\n// Actions\nexport const connect = () =>\n  new ActionBuilder<StarknetActions, 'connect'>('connect')\n    .and(connectAndUpdateStateForSingleNetwork)\n    .before(intoConnecting)\n    .after(intoConnectionFinished);\n\nexport const canEagerConnect = () =>\n  new ActionBuilder<StarknetActions, 'canEagerConnect'>('canEagerConnect');\n", "import type { ProviderAPI } from './types.js';\nimport type { CaipAccount } from '@hub3js/std/types';\n\nimport { AccountId } from 'caip';\n\nimport {\n  CAIP_NAMESPACE,\n  CAIP_STARKNET_CHAIN_ID,\n  CHAIN_ID,\n} from './constants.js';\n\nexport async function getAccounts(provider: ProviderAPI) {\n  const starknetResponse = await provider.connect();\n  /*\n   * Fallback for wallets that return no response on connect.\n   */\n  const account = starknetResponse\n    ? starknetResponse.publicKey.toString()\n    : provider.publicKey.toString();\n  return {\n    accounts: [account],\n    chainId: CHAIN_ID,\n  };\n}\n\nexport function formatAccountsToCAIP(accounts: string[]) {\n  return accounts.map(\n    (account) =>\n      AccountId.format({\n        address: account.toString(),\n        chainId: {\n          namespace: CAIP_NAMESPACE,\n          reference: CAIP_STARKNET_CHAIN_ID,\n        },\n      }) as CaipAccount,\n  );\n}\n", "/*\n * TODO: I couldn't found starknet in caip\n * @see https://namespaces.chainagnostic.org/\n */\n\n// if the value needs to be change make sure you will update mapCaipNamespaceToLegacyNetworkName as well\nexport const CAIP_NAMESPACE = 'starknet';\nexport const CAIP_STARKNET_CHAIN_ID = 'SN_MAIN';\nexport const CHAIN_ID = 'SOLANA';\n"],
+  "mappings": "6IAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,EAAA,gBAAAC,IAEA,OAAS,sBAAAC,MAA0B,sBAE5B,IAAMC,EAAc,CAAC,GAAGC,CAAkB,EAE1C,SAASC,EAAgBC,EAA6B,CAC3D,MAAO,UAAY,CACjB,IAAMC,EAAmBD,EAAS,EAElC,GAAI,CAACC,EACH,MAAM,IAAI,MACR,6FACF,EAGF,OAAOA,EAAiB,gBAAgB,CAC1C,CACF,CAZgBC,EAAAH,EAAA,mBCNhB,IAAAI,EAAA,GAAAC,EAAAD,EAAA,iBAAAE,IAAA,OAAS,oBAAAC,MAAwB,wBAE1B,IAAMD,EAAc,CAAC,GAAGC,CAAgB,ECF/C,IAAAC,EAAA,GAAAC,EAAAD,EAAA,iBAAAE,IAAA,OAAS,yCAAAC,MAA6C,wBAE/C,IAAMD,EAAc,CACzB,CAAC,UAAWC,CAAqC,CACnD,ECJA,IAAAC,EAAA,GAAAC,EAAAD,EAAA,iBAAAE,IAAA,OAAS,qBAAAC,MAAyB,wBAE3B,IAAMD,EAAc,CAAC,GAAGC,CAAiB,ECFhD,IAAAC,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,EAAA,YAAAC,IAEA,OAAS,iBAAAC,MAAqB,eAC9B,OACE,yCAAAC,EACA,kBAAAC,EACA,0BAAAC,MACK,wBAGA,IAAMC,EAAUC,EAAA,IACrB,IAAIC,EAA0C,SAAS,EACpD,IAAIC,CAAqC,EACzC,OAAOC,CAAc,EACrB,MAAMC,CAAsB,EAJV,WAMVC,EAAkBL,EAAA,IAC7B,IAAIC,EAAkD,iBAAiB,EAD1C,mBChB/B,IAAAK,EAAA,GAAAC,EAAAD,EAAA,0BAAAE,EAAA,gBAAAC,IAGA,OAAS,aAAAC,MAAiB,OCGnB,IAAMC,EAAiB,WACjBC,EAAyB,UACzBC,EAAW,SDGxB,eAAsBC,EAAYC,EAAuB,CACvD,IAAMC,EAAmB,MAAMD,EAAS,QAAQ,EAOhD,MAAO,CACL,SAAU,CAJIC,EACZA,EAAiB,UAAU,SAAS,EACpCD,EAAS,UAAU,SAAS,CAEZ,EAClB,QAASE,CACX,CACF,CAZsBC,EAAAJ,EAAA,eAcf,SAASK,EAAqBC,EAAoB,CACvD,OAAOA,EAAS,IACbC,GACCC,EAAU,OAAO,CACf,QAASD,EAAQ,SAAS,EAC1B,QAAS,CACP,UAAWE,EACX,UAAWC,CACb,CACF,CAAC,CACL,CACF,CAXgBN,EAAAC,EAAA",
+  "names": ["actions_exports", "__export", "canEagerConnect", "recommended", "recommendedActions", "recommended", "recommendedActions", "canEagerConnect", "instance", "starknetInstance", "__name", "after_exports", "__export", "recommended", "afterRecommended", "and_exports", "__export", "recommended", "connectAndUpdateStateForSingleNetwork", "before_exports", "__export", "recommended", "beforeRecommended", "builders_exports", "__export", "canEagerConnect", "connect", "ActionBuilder", "connectAndUpdateStateForSingleNetwork", "intoConnecting", "intoConnectionFinished", "connect", "__name", "ActionBuilder", "connectAndUpdateStateForSingleNetwork", "intoConnecting", "intoConnectionFinished", "canEagerConnect", "utils_exports", "__export", "formatAccountsToCAIP", "getAccounts", "AccountId", "CAIP_NAMESPACE", "CAIP_STARKNET_CHAIN_ID", "CHAIN_ID", "getAccounts", "provider", "starknetResponse", "CHAIN_ID", "__name", "formatAccountsToCAIP", "accounts", "account", "AccountId", "CAIP_NAMESPACE", "CAIP_STARKNET_CHAIN_ID"]
+}

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+import type { Accounts, AutoImplementedActionsByRecommended, CommonActions } from '@hub3js/std/types';
+export interface StarknetActions extends AutoImplementedActionsByRecommended, CommonActions {
+    connect: (options?: ConnectOptions) => Promise<Accounts>;
+    canEagerConnect: () => Promise<boolean>;
+}
+export type ProviderAPI = Record<string, any>;
+export type ConnectOptions = {
+    derivationPath?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,mCAAmC,EACnC,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,eACf,SAAQ,mCAAmC,EAAE,aAAa;IAC1D,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzD,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAGD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import type { ProviderAPI } from './types.js';
+export declare function getAccounts(provider: ProviderAPI): Promise<{
+    accounts: any[];
+    chainId: string;
+}>;
+export declare function formatAccountsToCAIP(accounts: string[]): `${string}:${string}:${string}`[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAW9C,wBAAsB,WAAW,CAAC,QAAQ,EAAE,WAAW;;;GAYtD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,qCAWtD"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@hub3js/starknet",
+  "version": "0.0.0-experimental-29a36fc0-20260720",
+  "license": "MIT",
+  "type": "module",
+  "source": "./src/mod.ts",
+  "main": "./dist/mod.js",
+  "typings": "./dist/mod.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/mod.d.ts",
+      "default": "./dist/mod.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "yarn run rangutopia library build",
+    "ts-check": "tsc --declaration --emitDeclarationOnly -p tsconfig.json",
+    "clean": "rimraf dist",
+    "format": "prettier --write '{.,src}/**/*.{ts,tsx}'",
+    "lint": "eslint \"**/*.{ts,tsx}\"",
+    "test": "vitest",
+    "coverage": "vitest run --coverage"
+  },
+  "peerDependencies": {
+    "@hub3js/core": "^0.0.0-experimental-29a36fc0-20260720"
+  },
+  "devDependencies": {
+    "@hub3js/core": "^0.0.0-experimental-29a36fc0-20260720"
+  },
+  "dependencies": {
+    "@hub3js/std": "^0.0.0-experimental-29a36fc0-20260720",
+    "caip": "^1.1.1",
+    "rango-types": "^0.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/readme.md

@@ -0,0 +1,3 @@
+# @hub3js/starknet
+
+Package for handling Starknet wallets supported by Rango

package/src/actions.ts

@@ -0,0 +1,19 @@
+import type { ProviderAPI } from './types.js';
+
+import { recommendedActions } from '@hub3js/std/actions';
+
+export const recommended = [...recommendedActions];
+
+export function canEagerConnect(instance: () => ProviderAPI) {
+  return async () => {
+    const starknetInstance = instance();
+
+    if (!starknetInstance) {
+      throw new Error(
+        'Trying to eagerly connect to your Starknet wallet, but seems its instance is not available.',
+      );
+    }
+
+    return starknetInstance.isPreauthorized();
+  };
+}

package/src/after.ts

@@ -0,0 +1,3 @@
+import { afterRecommended } from '@hub3js/std/operators';
+
+export const recommended = [...afterRecommended];

package/src/and.ts

@@ -0,0 +1,5 @@
+import { connectAndUpdateStateForSingleNetwork } from '@hub3js/std/operators';
+
+export const recommended = [
+  ['connect', connectAndUpdateStateForSingleNetwork] as const,
+];

package/src/before.ts

@@ -0,0 +1,3 @@
+import { beforeRecommended } from '@hub3js/std/operators';
+
+export const recommended = [...beforeRecommended];

package/src/builders.ts

@@ -0,0 +1,18 @@
+import type { StarknetActions } from './types.js';
+
+import { ActionBuilder } from '@hub3js/core';
+import {
+  connectAndUpdateStateForSingleNetwork,
+  intoConnecting,
+  intoConnectionFinished,
+} from '@hub3js/std/operators';
+
+// Actions
+export const connect = () =>
+  new ActionBuilder<StarknetActions, 'connect'>('connect')
+    .and(connectAndUpdateStateForSingleNetwork)
+    .before(intoConnecting)
+    .after(intoConnectionFinished);
+
+export const canEagerConnect = () =>
+  new ActionBuilder<StarknetActions, 'canEagerConnect'>('canEagerConnect');

package/src/constants.ts

@@ -0,0 +1,9 @@
+/*
+ * TODO: I couldn't found starknet in caip
+ * @see https://namespaces.chainagnostic.org/
+ */
+
+// if the value needs to be change make sure you will update mapCaipNamespaceToLegacyNetworkName as well
+export const CAIP_NAMESPACE = 'starknet';
+export const CAIP_STARKNET_CHAIN_ID = 'SN_MAIN';
+export const CHAIN_ID = 'SOLANA';

package/src/mod.ts

@@ -0,0 +1,9 @@
+export * as actions from './actions.js';
+export * as after from './after.js';
+export * as and from './and.js';
+export * as before from './before.js';
+export * as builders from './builders.js';
+export * as utils from './utils.js';
+
+export type { ProviderAPI, StarknetActions } from './types.js';
+export { CAIP_NAMESPACE, CAIP_STARKNET_CHAIN_ID } from './constants.js';

package/src/types.ts

@@ -0,0 +1,18 @@
+import type {
+  Accounts,
+  AutoImplementedActionsByRecommended,
+  CommonActions,
+} from '@hub3js/std/types';
+
+export interface StarknetActions
+  extends AutoImplementedActionsByRecommended, CommonActions {
+  connect: (options?: ConnectOptions) => Promise<Accounts>;
+  canEagerConnect: () => Promise<boolean>;
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type ProviderAPI = Record<string, any>;
+
+export type ConnectOptions = {
+  derivationPath?: string;
+};

package/src/utils.ts

@@ -0,0 +1,37 @@
+import type { ProviderAPI } from './types.js';
+import type { CaipAccount } from '@hub3js/std/types';
+
+import { AccountId } from 'caip';
+
+import {
+  CAIP_NAMESPACE,
+  CAIP_STARKNET_CHAIN_ID,
+  CHAIN_ID,
+} from './constants.js';
+
+export async function getAccounts(provider: ProviderAPI) {
+  const starknetResponse = await provider.connect();
+  /*
+   * Fallback for wallets that return no response on connect.
+   */
+  const account = starknetResponse
+    ? starknetResponse.publicKey.toString()
+    : provider.publicKey.toString();
+  return {
+    accounts: [account],
+    chainId: CHAIN_ID,
+  };
+}
+
+export function formatAccountsToCAIP(accounts: string[]) {
+  return accounts.map(
+    (account) =>
+      AccountId.format({
+        address: account.toString(),
+        chainId: {
+          namespace: CAIP_NAMESPACE,
+          reference: CAIP_STARKNET_CHAIN_ID,
+        },
+      }) as CaipAccount,
+  );
+}