@dngbuilds/zapkit-core 0.0.1

package/README.md

@@ -0,0 +1,23 @@
+# vite-plus-starter
+
+A starter for creating a Vite Plus project.
+
+## Development
+
+- Install dependencies:
+
+```bash
+vp install
+```
+
+- Run the unit tests:
+
+```bash
+vp test
+```
+
+- Build the library:
+
+```bash
+vp pack
+```

package/dist/index.d.mts

@@ -0,0 +1,66 @@
+import * as starkzap from "starkzap";
+import { Address, Amount, BridgeToken, Call, CartridgeWalletInterface, ChainId, ConnectCartridgeBaseOptions, ConnectWalletOptions, EnsureReadyOptions, ExecuteOptions, ExternalChain, OnboardOptions, OnboardResult, OnboardStrategy, Pool, RpcProvider, SDKConfig, StarkSigner, Token, Tx, TxBuilder, Wallet, accountPresets, fromAddress, getPresets } from "starkzap";
+import { CartridgeWallet } from "starkzap/cartridge";
+
+//#region src/index.d.ts
+type ConnectCartridgeOptions = NonNullable<Extract<OnboardOptions, {
+  strategy: "cartridge";
+}>["cartridge"]> & ConnectCartridgeBaseOptions;
+interface ZapKitConfig extends SDKConfig {}
+declare class ZapKit {
+  private sdk;
+  private currentWallet;
+  private _cartridgeWallet;
+  constructor(config: ZapKitConfig);
+  /** ==================== ONBOARD & WALLET ==================== */
+  onboard(params: OnboardOptions): Promise<OnboardResult<starkzap.WalletInterface>>;
+  connectWallet(options: ConnectWalletOptions): Promise<Wallet>;
+  getWallet(): Wallet | CartridgeWallet | null;
+  disconnect(): Promise<void>;
+  ensureReady(options?: EnsureReadyOptions): Promise<void>;
+  /** ==================== STAKING ==================== */
+  stakingTokens(): Promise<Token[]>;
+  getStakerPools(staker: Address): Promise<Pool[]>;
+  stake(params: {
+    poolAddress: Address;
+    amount: Amount;
+    options?: ExecuteOptions;
+  }): Promise<Tx>;
+  claimRewards(poolAddress: Address, options?: ExecuteOptions): Promise<Tx>;
+  /** ==================== BRIDGING ==================== */
+  getBridgingTokens(chain?: ExternalChain): Promise<BridgeToken[]>;
+  /** ==================== CARTRIDGE ==================== */
+  /**
+   * Connect using Cartridge Controller (social login / passkeys).
+   * Requires `@cartridge/controller` to be installed as an app dependency.
+   *
+   * @example
+   * const wallet = await kit.connectCartridge({ policies: [...] });
+   */
+  connectCartridge(options?: ConnectCartridgeOptions): Promise<CartridgeWalletInterface>;
+  /** ==================== PROVIDER & CONTRACT ==================== */
+  getProvider(): RpcProvider;
+  callContract(call: Call): ReturnType<RpcProvider["callContract"]>;
+  /** ==================== UTILITIES ==================== */
+  get utils(): {
+    Amount: typeof Amount;
+    fromAddress: typeof fromAddress;
+    getPresets: typeof getPresets;
+    accountPresets: {
+      readonly devnet: starkzap.AccountClassConfig;
+      readonly openzeppelin: starkzap.AccountClassConfig;
+      readonly argent: starkzap.AccountClassConfig;
+      readonly braavos: starkzap.AccountClassConfig;
+      readonly argentXV050: starkzap.AccountClassConfig;
+    };
+    OnboardStrategy: {
+      readonly Signer: "signer";
+      readonly Privy: "privy";
+      readonly Cartridge: "cartridge";
+    };
+    StarkSigner: typeof StarkSigner;
+  };
+  getBalance(token: Token): Promise<Amount>;
+}
+//#endregion
+export { type Address, Amount, BridgeToken, type Call, type CartridgeWalletInterface, ChainId, type ConnectCartridgeBaseOptions, ConnectCartridgeOptions, type ConnectWalletOptions, type EnsureReadyOptions, type ExecuteOptions, ExternalChain, type OnboardOptions, type OnboardResult, OnboardStrategy, type Pool, type RpcProvider, type SDKConfig, StarkSigner, type Token, Tx, TxBuilder, type Wallet, ZapKit, ZapKit as default, ZapKitConfig, accountPresets, fromAddress, getPresets };

package/dist/index.mjs

@@ -0,0 +1,109 @@
+import { Amount, BridgeToken, ChainId, ExternalChain, OnboardStrategy, StarkSigner, StarkZap, Tx, TxBuilder, accountPresets, fromAddress, getPresets } from "starkzap";
+//#region src/index.ts
+var ZapKit = class {
+	sdk;
+	currentWallet = null;
+	_cartridgeWallet = null;
+	constructor(config) {
+		this.sdk = new StarkZap(config);
+		const network = config.network ?? "sepolia";
+		console.log(`🚀 ZapKit initialized on ${String(network)}`);
+	}
+	/** ==================== ONBOARD & WALLET ==================== */
+	async onboard(params) {
+		if (params.strategy === "cartridge" && this._cartridgeWallet) {
+			this.currentWallet = this._cartridgeWallet;
+			return {
+				wallet: this.currentWallet,
+				strategy: params.strategy,
+				deployed: await this.currentWallet.isDeployed()
+			};
+		}
+		const result = await this.sdk.onboard(params);
+		this.currentWallet = result.wallet;
+		if (params.strategy === "cartridge") this._cartridgeWallet = this.currentWallet;
+		return result;
+	}
+	async connectWallet(options) {
+		const wallet = await this.sdk.connectWallet(options);
+		this.currentWallet = wallet;
+		return wallet;
+	}
+	getWallet() {
+		return this.currentWallet;
+	}
+	async disconnect() {
+		if (this.currentWallet) {
+			if (this._cartridgeWallet === this.currentWallet) {
+				this.currentWallet = null;
+				return;
+			}
+			try {
+				await this.currentWallet.disconnect();
+			} catch {}
+			this.currentWallet = null;
+		}
+	}
+	async ensureReady(options) {
+		if (!this.currentWallet) throw new Error("Wallet not connected. Call onboard() or connectWallet() first.");
+		await this.currentWallet.ensureReady(options);
+	}
+	/** ==================== STAKING ==================== */
+	async stakingTokens() {
+		return this.sdk.stakingTokens();
+	}
+	async getStakerPools(staker) {
+		return this.sdk.getStakerPools(staker);
+	}
+	async stake(params) {
+		if (!this.currentWallet) throw new Error("Wallet not connected.");
+		const tx = await this.currentWallet.enterPool(params.poolAddress, params.amount, params.options);
+		await tx.wait();
+		return tx;
+	}
+	async claimRewards(poolAddress, options) {
+		if (!this.currentWallet) throw new Error("Wallet not connected.");
+		return this.currentWallet.claimPoolRewards(poolAddress, options);
+	}
+	/** ==================== BRIDGING ==================== */
+	async getBridgingTokens(chain) {
+		return this.sdk.getBridgingTokens(chain);
+	}
+	/** ==================== CARTRIDGE ==================== */
+	/**
+	* Connect using Cartridge Controller (social login / passkeys).
+	* Requires `@cartridge/controller` to be installed as an app dependency.
+	*
+	* @example
+	* const wallet = await kit.connectCartridge({ policies: [...] });
+	*/
+	async connectCartridge(options) {
+		const wallet = await this.sdk.connectCartridge(options);
+		this.currentWallet = wallet;
+		return wallet;
+	}
+	/** ==================== PROVIDER & CONTRACT ==================== */
+	getProvider() {
+		return this.sdk.getProvider();
+	}
+	callContract(call) {
+		return this.sdk.callContract(call);
+	}
+	/** ==================== UTILITIES ==================== */
+	get utils() {
+		return {
+			Amount,
+			fromAddress,
+			getPresets,
+			accountPresets,
+			OnboardStrategy,
+			StarkSigner
+		};
+	}
+	async getBalance(token) {
+		if (!this.currentWallet) throw new Error("Wallet not connected.");
+		return this.currentWallet.balanceOf(token);
+	}
+};
+//#endregion
+export { Amount, BridgeToken, ChainId, ExternalChain, OnboardStrategy, StarkSigner, Tx, TxBuilder, ZapKit, ZapKit as default, accountPresets, fromAddress, getPresets };

package/dist/vite.d.mts

@@ -0,0 +1,35 @@
+//#region src/vite.d.ts
+/**
+ * Vite plugin for ZapKit — resolves optional starkzap peer dependencies to
+ * virtual no-op shims so your app bundles without errors even when those
+ * packages aren't installed.
+ *
+ * Uses Vite virtual modules instead of filesystem shims so the plugin works
+ * correctly when the config file is bundled (import.meta.url is rewritten
+ * to a temp path during config bundling).
+ *
+ * Optional starkzap dependencies covered:
+ *   @avnu/avnu-sdk          — AVNU swap / DCA routing
+ *   @fatsolutions/tongo-sdk — TON bridge (confidential transactions)
+ *   @hyperlane-xyz/sdk      — Hyperlane bridge (type-only, no runtime shim needed)
+ *   @solana/web3.js         — Solana bridge (dynamically imported by starkzap)
+ *
+ * NOT shimmed (bundled as real deps in @zapkit/core):
+ *   @cartridge/controller   — included automatically, OnboardStrategy.Cartridge works out of the box
+ *
+ * @example
+ * // vite.config.ts
+ * import { defineConfig } from "vite";
+ * import { zapkitPlugin } from "@zapkit/core/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [zapkitPlugin()],
+ * });
+ */
+declare function zapkitPlugin(): {
+  name: string;
+  resolveId(id: string): string | undefined;
+  load(id: string): string | undefined;
+};
+//#endregion
+export { zapkitPlugin };

package/dist/vite.mjs

@@ -0,0 +1,69 @@
+//#region src/vite.ts
+/**
+* Vite plugin for ZapKit — resolves optional starkzap peer dependencies to
+* virtual no-op shims so your app bundles without errors even when those
+* packages aren't installed.
+*
+* Uses Vite virtual modules instead of filesystem shims so the plugin works
+* correctly when the config file is bundled (import.meta.url is rewritten
+* to a temp path during config bundling).
+*
+* Optional starkzap dependencies covered:
+*   @avnu/avnu-sdk          — AVNU swap / DCA routing
+*   @fatsolutions/tongo-sdk — TON bridge (confidential transactions)
+*   @hyperlane-xyz/sdk      — Hyperlane bridge (type-only, no runtime shim needed)
+*   @solana/web3.js         — Solana bridge (dynamically imported by starkzap)
+*
+* NOT shimmed (bundled as real deps in @zapkit/core):
+*   @cartridge/controller   — included automatically, OnboardStrategy.Cartridge works out of the box
+*
+* @example
+* // vite.config.ts
+* import { defineConfig } from "vite";
+* import { zapkitPlugin } from "@zapkit/core/vite";
+*
+* export default defineConfig({
+*   plugins: [zapkitPlugin()],
+* });
+*/
+const VIRTUAL_PREFIX = "\0zapkit-shim:";
+/** Shim source code keyed by package name */
+const SHIMS = {
+	"@fatsolutions/tongo-sdk": `
+export class Account {
+  constructor() {
+    throw new Error("[zapkit] @fatsolutions/tongo-sdk is not available. Install it to use TON bridge features.");
+  }
+}
+export default {};
+`,
+	"@hyperlane-xyz/sdk": `export default {};`,
+	"@solana/web3.js": `export default {};`,
+	"@avnu/avnu-sdk": `
+const notInstalled = (name) => () => {
+  throw new Error(\`[zapkit] @avnu/avnu-sdk "\${name}" is not available. Install @avnu/avnu-sdk to use swap/DCA features.\`);
+};
+export const getQuotes = notInstalled("getQuotes");
+export const quoteToCalls = notInstalled("quoteToCalls");
+export const cancelDcaToCalls = notInstalled("cancelDcaToCalls");
+export const createDcaToCalls = notInstalled("createDcaToCalls");
+export const getDcaOrders = notInstalled("getDcaOrders");
+export const DcaOrderStatus = {};
+export const BASE_URL = "https://starknet.api.avnu.fi";
+export const SEPOLIA_BASE_URL = "https://sepolia.api.avnu.fi";
+export default {};
+`
+};
+function zapkitPlugin() {
+	return {
+		name: "zapkit",
+		resolveId(id) {
+			if (id in SHIMS) return VIRTUAL_PREFIX + id;
+		},
+		load(id) {
+			if (id.startsWith(VIRTUAL_PREFIX)) return SHIMS[id.slice(13)];
+		}
+	};
+}
+//#endregion
+export { zapkitPlugin };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@dngbuilds/zapkit-core",
+  "version": "0.0.1",
+  "description": "Zapkit core package.",
+  "homepage": "",
+  "bugs": {
+    "url": ""
+  },
+  "license": "MIT",
+  "author": "DngBuilds <dng.builds@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/author/library.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./vite": "./dist/vite.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.mjs",
+      "./vite": "./dist/vite.mjs",
+      "./package.json": "./package.json"
+    },
+    "main": "./dist/index.mjs",
+    "types": "./dist/index.d.mts"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check",
+    "prepublishOnly": "vp run build"
+  },
+  "dependencies": {
+    "@cartridge/controller": "^0.13.9",
+    "react": "catalog:",
+    "starkzap": "latest"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@typescript/native-preview": "7.0.0-dev.20260316.1",
+    "bumpp": "^11.0.1",
+    "typescript": "^5.9.3",
+    "vite-plus": "^0.1.11",
+    "vitest": "catalog:"
+  }
+}