@cloakely/sdk 0.5.0 → 0.6.0

package/README.md

@@ -22,14 +22,16 @@ npm install @cloakely/sdk viem
 
 ```ts
 import { createPublicClient, createWalletClient, custom, http, parseEther } from "viem";
-import { Cloak, deploymentFor, elysiumTestnet } from "@cloakely/sdk";
+import { Cloak, deploymentFor, elysiumTestnet, legacyFactories } from "@cloakely/sdk";
 
 const d = deploymentFor(elysiumTestnet.id);
 const publicClient = createPublicClient({ chain: elysiumTestnet, transport: http() });
 const walletClient = createWalletClient({ chain: elysiumTestnet, transport: custom(window.ethereum) });
-const cloak = new Cloak(publicClient, walletClient, d.factory, d.legacy?.factory);
+// earlier factories too, so every launch lists, settles and pays out
+const cloak = new Cloak(publicClient, walletClient, d.factory, legacyFactories(d));
 
-// a project or launchpad: a sealed-bid launch, with liquidity seeded at the clearing price
+// a project or launchpad: a sealed-bid launch. At settlement it opens a Uniswap V2 pool (token / WHYPE) at the
+// clearing price, with the LP burned ("burn") or locked until a date
 const now = Math.floor(Date.now() / 1000);
 const { auction } = await cloak.createLaunch({
   name: "Shade", symbol: "SHADE",
@@ -47,6 +49,10 @@ await cloak.revealAll(auction);
 await cloak.settle(auction);
 await cloak.claimAll(auction);
 await cloak.payOut(auction); // the creator's proceeds, and the launch fee to the treasury
+
+const s = await cloak.getAuction(auction);
+s.uniPair; // the Uniswap V2 pool, tradable and trackable anywhere (zero for launches before Nov 2, which use a CloakPair)
+s.pair;    // the market Cloak's private router and batcher trade: a CloakV2Market in front of that pool
 ```
 
 ## Private trading
@@ -55,17 +61,17 @@ await cloak.payOut(auction); // the creator's proceeds, and the launch fee to th
 import { CloakPrivate, deploymentFor, elysiumTestnet, loadProver, relayerSubmitter } from "@cloakely/sdk";
 
 const d = deploymentFor(elysiumTestnet.id);
-const keys = await CloakPrivate.keysFromWallet(walletClient, { chainId: d.chainId, router: d.router, verify: true });
+const keys = await CloakPrivate.keysFromWallet(walletClient, { chainId: d.chainId, verify: true });
 const priv = new CloakPrivate(
   publicClient, d.router, keys,
   () => loadProver(d.circuitsUrl),     // 12 MB of circuit files, fetched once and hash-checked
   relayerSubmitter(d.relayerUrl),      // the relayer submits, so the wallet never appears
-  d.routerBlock, d.batcher, d.migrator,
+  d.vaultsBlock!, d.batcher, d.migrator, // notes are scanned from the permanent vaults' first block
 );
 await priv.loadMarkets();
 
 await priv.shieldHype(walletClient, parseEther("1"));     // the one public step
-await priv.buy(token, parseEther("0.25"));                // private buy through the launch's pool
+await priv.buy(token, parseEther("0.25"));                // private buy through the launch's Uniswap pool
 await priv.batch(token, "buy", parseEther("0.37"));       // batch round: trade size hidden too
 await priv.send(token, "cloak:…", parseEther("100"));     // private transfer: amount hidden
 await priv.unshieldHype(freshAddress, parseEther("0.5")); // back to any wallet
@@ -81,7 +87,7 @@ await priv.send(usdc.token, "cloak:…", parseUnits("20", 6));             // am
 await priv.unshieldToken(usdc.token, freshAddress, parseUnits("10", 6)); // 0.25% fee kept
 ```
 
-The private account comes from one EIP-712 signature bound to the chain and the router. The same wallet always restores it, and nothing is stored on a server. In Node, read the circuit files yourself and pass them to `createProver(wasm, zkey)`.
+The private account comes from one EIP-712 signature bound to the chain only (never to a contract), so it and the `cloak:` address never change. The same wallet always restores it, and nothing is stored on a server. In Node, read the circuit files yourself and pass them to `createProver(wasm, zkey)`.
 
 ## Fees (testnet beta)
 
@@ -92,7 +98,7 @@ The private account comes from one EIP-712 signature bound to the chain and the
 | Successful launch | 1.5% of the raise |
 | Relayer | the relayer's gas plus a margin, paid inside the proof |
 
-Rules live in the on-chain `CloakConfig`. Raising a fee or a cap waits a public 3-day delay, and no function in any Cloak contract can move user funds.
+Rules live in the on-chain `CloakConfig`, and no function in any Cloak contract can move user funds. Testnet is still in setup, so the owner can change fees and caps at once (within hard ceilings of 1% and 3%); once setup ends, before mainnet, raising a fee or a cap waits a public 3-day delay. Every rule with its number: [docs/RULES.md](https://github.com/NECOKIZZ/Cloak/blob/main/docs/RULES.md).
 
 ## Exports
 

package/dist/abis.d.ts

@@ -912,6 +912,10 @@ export declare const cloakFactoryAbi: readonly [{
         readonly name: "seeder_";
         readonly type: "address";
         readonly internalType: "contract IMarketSeeder";
+    }, {
+        readonly name: "feeLocker_";
+        readonly type: "address";
+        readonly internalType: "contract IFeeLocker";
     }];
     readonly stateMutability: "nonpayable";
 }, {
@@ -1031,6 +1035,16 @@ export declare const cloakFactoryAbi: readonly [{
         readonly internalType: "address";
     }];
     readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "feeLocker";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IFeeLocker";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "launches";
@@ -1219,6 +1233,10 @@ export declare const cloakAuctionAbi: readonly [{
         readonly name: "seeder_";
         readonly type: "address";
         readonly internalType: "contract IMarketSeeder";
+    }, {
+        readonly name: "feeLocker_";
+        readonly type: "address";
+        readonly internalType: "contract IFeeLocker";
     }];
     readonly stateMutability: "nonpayable";
 }, {
@@ -1254,6 +1272,16 @@ export declare const cloakAuctionAbi: readonly [{
         readonly internalType: "uint256";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "LOCK_FOREVER_FEES";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "MAX_TICKS";
@@ -1476,6 +1504,16 @@ export declare const cloakAuctionAbi: readonly [{
         readonly internalType: "uint256";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "creatorFees";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "creatorOwed";
@@ -1540,6 +1578,26 @@ export declare const cloakAuctionAbi: readonly [{
         readonly internalType: "bool";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "feeLocker";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IFeeLocker";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "feePosition";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "feesOwed";
@@ -2002,6 +2060,21 @@ export declare const cloakAuctionAbi: readonly [{
         readonly internalType: "bytes";
     }];
     readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "CreatorFeesOn";
+    readonly inputs: readonly [{
+        readonly name: "locker";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "position";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
 }, {
     readonly type: "event";
     readonly name: "DustSwept";
@@ -5591,3 +5664,214 @@ export declare const cloakV2MarketAbi: readonly [{
     }];
     readonly anonymous: false;
 }];
+export declare const cloakFeeLockerAbi: readonly [{
+    readonly type: "function";
+    readonly name: "claim";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amount0";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "amount1";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claimable";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lp";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "claimableAmounts";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amount0";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "amount1";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lockFor";
+    readonly inputs: readonly [{
+        readonly name: "pair";
+        readonly type: "address";
+        readonly internalType: "contract IUniswapV2Pair";
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "beneficiary";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "positions";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct CloakFeeLocker.Position";
+        readonly components: readonly [{
+            readonly name: "pair";
+            readonly type: "address";
+            readonly internalType: "contract IUniswapV2Pair";
+        }, {
+            readonly name: "beneficiary";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "shares";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "locked";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "positionsCount";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "setBeneficiary";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "BeneficiaryChanged";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "FeesClaimed";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "beneficiary";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "amount0";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "amount1";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Locked";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "pair";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "beneficiary";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "NotBeneficiary";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "Zero";
+    readonly inputs: readonly [];
+}];