clanker-sdk 3.9.8 → 3.9.9

package/README.md

@@ -146,7 +146,8 @@ async function prepareTokenDeployment() {
 ### Basic Token Configuration
 - `name`: Token name
 - `symbol`: Token symbol
-- `salt`: Randomly generated bytes32 value
+- `salt`: Optional bytes32 value (must be "0x" + 64 hex characters), defaults to all zeros
+- `creatorReward`: Optional percentage (0-80) controlling reward distribution between creator and interface, defaults to 80%
 - `image`: IPFS hash for token image
 - `metadata`: IPFS hash for token metadata
 - `context`: Deployment context string
@@ -162,6 +163,10 @@ const tokenAddress = await clanker.deployToken({
   name: "Test Token",
   symbol: "TEST",
   
+  // Optional configuration with validation
+  salt: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", // Must be 0x + 64 hex chars
+  creatorReward: 60, // Must be between 0-80, defaults to 80
+  
   // Metadata configuration
   metadata: {
     description: "Test token deployment",

package/dist/cli/ascii.txt

@@ -0,0 +1,20 @@
+ .--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--. 
+/ .. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \
+\ \/\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ \/ /
+ \/ /`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'\/ / 
+ / /\  ````````````````````````````````````````````````````````````````````````````````````  / /\ 
+/ /\ \ ```````````````````````````````````````````````````````````````````````````````````` / /\ \
+\ \/ / ```````::::::::``:::````````````:::`````::::````:::`:::````:::`::::::::::`:::::::::` \ \/ /
+ \/ /  `````:+:````:+:`:+:``````````:+:`:+:```:+:+:```:+:`:+:```:+:``:+:````````:+:````:+:`  \/ / 
+ / /\  ````+:+````````+:+`````````+:+```+:+``:+:+:+``+:+`+:+``+:+```+:+````````+:+````+:+``  / /\ 
+/ /\ \ ```+#+````````+#+````````+#++:++#++:`+#+`+:+`+#+`+#++:++````+#++:++#```+#++:++#:```` / /\ \
+\ \/ / ``+#+````````+#+````````+#+`````+#+`+#+``+#+#+#`+#+``+#+```+#+````````+#+````+#+```` \ \/ /
+ \/ /  `#+#````#+#`#+#````````#+#`````#+#`#+#```#+#+#`#+#```#+#``#+#````````#+#````#+#`````  \/ / 
+ / /\  `########``##########`###`````###`###````####`###````###`##########`###````###``````  / /\ 
+/ /\ \ ```````````````````````````````````````````````````````````````````````````````````` / /\ \
+\ \/ / ```````````````````````````````````````````````````````````````````````````````````` \ \/ /
+ \/ /  ````````````````````````````````````````````````````````````````````````````````````  \/ / 
+ / /\.--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--..--./ /\ 
+/ /\ \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \.. \/\ \
+\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `'\ `' /
+ `--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--'`--' 

package/dist/cli/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/cli.js

@@ -10,9 +10,15 @@ var __export = (target, all) => {
 };
 
 // node_modules/tsup/assets/esm_shims.js
+import { fileURLToPath } from "url";
+import path from "path";
+var getFilename, getDirname, __dirname;
 var init_esm_shims = __esm({
   "node_modules/tsup/assets/esm_shims.js"() {
     "use strict";
+    getFilename = () => fileURLToPath(import.meta.url);
+    getDirname = () => path.dirname(getFilename());
+    __dirname = /* @__PURE__ */ getDirname();
   }
 });
 
@@ -820,7 +826,14 @@ var init_index = __esm({
           tokenConfig: {
             name: cfg.name,
             symbol: cfg.symbol,
-            salt: cfg.salt || "0x0000000000000000000000000000000000000000000000000000000000000000",
+            salt: (() => {
+              const defaultSalt = "0x0000000000000000000000000000000000000000000000000000000000000000";
+              const salt = cfg.salt ?? defaultSalt;
+              if (!/^0x[a-fA-F0-9]{64}$/.test(salt)) {
+                throw new Error("Salt must be a valid bytes32 value (0x + 64 hex characters)");
+              }
+              return salt;
+            })(),
             image: cfg.image || "https://ipfs.io/ipfs/QmcjfTeK3tpK3MVCQuvEaXvSscrqbL3MwsEo8LdBTWabY4",
             metadata: JSON.stringify(cfg.metadata || {
               description: "Clanker Token",
@@ -849,12 +862,17 @@ var init_index = __esm({
           },
           initialBuyConfig,
           rewardsConfig: {
-            creatorReward: BigInt(40),
-            // Default to 40% creator reward
-            creatorAdmin: deployerAddress,
-            creatorRewardRecipient: deployerAddress,
-            interfaceAdmin: deployerAddress,
-            interfaceRewardRecipient: deployerAddress
+            creatorReward: (() => {
+              const reward = cfg.rewardsConfig?.creatorReward ?? 80;
+              if (reward < 0 || reward > 80) {
+                throw new Error("Creator reward must be between 0 and 80");
+              }
+              return BigInt(reward);
+            })(),
+            creatorAdmin: cfg.rewardsConfig?.creatorAdmin ?? deployerAddress,
+            creatorRewardRecipient: cfg.rewardsConfig?.creatorRewardRecipient ?? deployerAddress,
+            interfaceAdmin: cfg.rewardsConfig?.interfaceAdmin ?? deployerAddress,
+            interfaceRewardRecipient: cfg.rewardsConfig?.interfaceRewardRecipient ?? deployerAddress
           }
         };
       }
@@ -904,28 +922,25 @@ var init_index = __esm({
 // src/cli/create-clanker.ts
 var create_clanker_exports = {};
 __export(create_clanker_exports, {
-  default: () => createClanker
+  default: () => create_clanker_default
 });
 import inquirer from "inquirer";
 import { createPublicClient, createWalletClient, http } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 import { base } from "viem/chains";
 import * as dotenv from "dotenv";
+import * as fs from "fs";
+import * as path2 from "path";
 async function createClanker() {
-  const args = process.argv.slice(2);
-  if (args.length === 0 || args[0] !== "--create" && args[0] !== "create") {
-    console.log("\n\u{1F680} Clanker SDK CLI\n");
-    console.log("Available commands:");
-    console.log("  --create    Create a new token");
-    console.log("\nExample:");
-    console.log("  npx clanker-sdk --create\n");
-    process.exit(0);
-  }
   const PRIVATE_KEY = process.env.PRIVATE_KEY;
   const FACTORY_ADDRESS = process.env.FACTORY_ADDRESS;
   const RPC_URL = process.env.RPC_URL;
   const WETH_ADDRESS2 = "0x4200000000000000000000000000000000000006";
   const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+  function toHexAddress(address) {
+    if (!address) return void 0;
+    return address.toLowerCase();
+  }
   function checkEnvironment() {
     const missingVars = [];
     if (!PRIVATE_KEY) missingVars.push("PRIVATE_KEY");
@@ -973,8 +988,8 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
   };
   const validateSymbol = (input) => {
     if (!input) return "Symbol cannot be empty";
-    if (!/^[A-Z0-9]+$/.test(input)) return "Symbol must contain only uppercase letters and numbers";
-    if (input.length > 10) return "Symbol must be 10 characters or less";
+    if (!/^[a-zA-Z0-9]+$/.test(input)) return "Symbol must contain only letters and numbers";
+    if (input.length > 20) return "Symbol must be 20 characters or less";
     return true;
   };
   const validateIpfsUri = (input) => {
@@ -1031,18 +1046,21 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "name",
         message: "Token name:",
+        prefix: "",
         validate: (input) => input.length > 0 || "Name cannot be empty"
       },
       {
         type: "input",
         name: "symbol",
         message: "Token symbol:",
+        prefix: "",
         validate: validateSymbol
       },
       {
         type: "list",
         name: "pairedTokenChoice",
         message: "Select quote token:",
+        prefix: "",
         choices: [
           { name: "WETH", value: "WETH" },
           { name: "USDC", value: "USDC" },
@@ -1054,6 +1072,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customPairedToken",
         message: "Enter custom token address:",
+        prefix: "",
         validate: validateAddress,
         when: (answers2) => answers2.pairedTokenChoice === "CUSTOM"
       },
@@ -1061,6 +1080,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "initialMarketCapUsd",
         message: (answers2) => `Enter initial market cap in ${answers2.pairedTokenChoice === "CUSTOM" ? "quote token" : answers2.pairedTokenChoice}:`,
+        prefix: "",
         validate: validateAmount,
         default: (answers2) => answers2.pairedTokenChoice === "WETH" ? "1" : answers2.pairedTokenChoice === "USDC" ? "1000" : "1"
       },
@@ -1068,6 +1088,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customMarketCap",
         message: "Enter custom market cap in quote token:",
+        prefix: "",
         validate: validateAmount,
         when: (answers2) => answers2.initialMarketCapUsd === "CUSTOM"
       },
@@ -1075,12 +1096,14 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "image",
         message: "Enter the IPFS URI for the token image:",
+        prefix: "",
         validate: validateIpfsUri
       },
       {
         type: "list",
         name: "devBuy.ethAmount",
         message: "Creator buy amount (optional):",
+        prefix: "",
         choices: [
           { name: "None", value: "0" },
           { name: "0.00005 ETH", value: "0.00005" },
@@ -1095,6 +1118,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customDevBuy",
         message: "Enter custom dev buy amount in ETH:",
+        prefix: "",
         validate: validateAmount,
         when: (answers2) => answers2.devBuy.ethAmount === "CUSTOM"
       },
@@ -1102,6 +1126,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "devBuy.maxSlippage",
         message: "Maximum slippage percentage (0-100):",
+        prefix: "",
         validate: validateSlippage,
         default: "5",
         when: (answers2) => answers2.devBuy.ethAmount !== "0"
@@ -1110,6 +1135,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "list",
         name: "vaultConfig.vaultPercentage",
         message: "Vault percentage (optional):",
+        prefix: "",
         choices: [
           { name: "None", value: "0" },
           { name: "5%", value: "5" },
@@ -1123,6 +1149,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customVaultPercentage",
         message: "Enter custom vault percentage (0-30):",
+        prefix: "",
         validate: validateVaultPercentage,
         when: (answers2) => answers2.vaultConfig.vaultPercentage === "CUSTOM"
       },
@@ -1130,6 +1157,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "list",
         name: "vaultConfig.durationInDays",
         message: "Vault duration:",
+        prefix: "",
         choices: [
           { name: "31 days", value: "31" },
           { name: "90 days", value: "90" },
@@ -1143,6 +1171,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customVaultDuration",
         message: "Enter custom vault duration in days (minimum 30):",
+        prefix: "",
         validate: validateVaultDuration,
         when: (answers2) => answers2.vaultConfig.durationInDays === "CUSTOM"
       },
@@ -1150,6 +1179,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "metadata.description",
         message: "Token description:",
+        prefix: "",
         default: (answers2) => `${answers2.name} token deployed via Clanker CLI`,
         validate: (input) => input.length > 0 || "Description cannot be empty"
       },
@@ -1157,28 +1187,96 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "metadata.telegram",
         message: "Telegram URL (optional):",
+        prefix: "",
         validate: validateUrl
       },
       {
         type: "input",
         name: "metadata.website",
         message: "Website URL (optional):",
+        prefix: "",
         validate: validateUrl
       },
       {
         type: "input",
         name: "metadata.twitter",
         message: "X/Twitter URL (optional):",
+        prefix: "",
         validate: validateUrl
       },
       {
         type: "input",
         name: "metadata.farcaster",
         message: "Farcaster URL (optional):",
+        prefix: "",
         validate: validateUrl
+      },
+      {
+        type: "input",
+        name: "salt",
+        message: "Enter custom salt (optional, press enter for default 0x0000...):",
+        prefix: "",
+        validate: (input) => {
+          if (!input) return true;
+          if (!/^0x[a-fA-F0-9]{64}$/.test(input)) {
+            return "Salt must be a valid bytes32 value (0x + 64 hex characters)";
+          }
+          return true;
+        }
+      },
+      {
+        type: "list",
+        name: "rewardsConfig.creatorReward",
+        message: "Creator reward percentage, balance remaining goes to interface:",
+        prefix: "",
+        choices: [
+          { name: "80% (maximum)", value: 80 },
+          { name: "60%", value: 60 },
+          { name: "40%", value: 40 },
+          { name: "20%", value: 20 },
+          { name: "0% (all to interface)", value: 0 },
+          { name: "Custom", value: "CUSTOM" }
+        ],
+        default: 80
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.customCreatorReward",
+        message: "Enter custom creator reward percentage (0-80):",
+        prefix: "",
+        validate: validateCreatorReward,
+        when: (answers2) => answers2.rewardsConfig.creatorReward === "CUSTOM"
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.creatorAdmin",
+        message: "Enter custom creator admin address (optional):",
+        prefix: "",
+        validate: validateAddress
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.creatorRewardRecipient",
+        message: "Enter custom creator reward recipient address (optional):",
+        prefix: "",
+        validate: validateAddress
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.interfaceAdmin",
+        message: "Enter custom interface admin address (optional):",
+        prefix: "",
+        validate: validateAddress
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.interfaceRewardRecipient",
+        message: "Enter custom interface reward recipient address (optional):",
+        prefix: "",
+        validate: validateAddress
       }
     ];
-    const answers = await inquirer.prompt(questions);
+    const answers = await inquirer.prompt(questions, {});
     if (answers.initialMarketCapUsd === "CUSTOM") {
       answers.initialMarketCapUsd = answers.customMarketCap || "0";
     }
@@ -1203,6 +1301,21 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
       vaultConfig: {
         vaultPercentage: vaultPercentage.toString(),
         durationInDays: vaultDuration.toString()
+      },
+      rewardsConfig: {
+        creatorReward: answers.rewardsConfig.creatorReward === "CUSTOM" ? Number(answers.rewardsConfig.customCreatorReward) : Number(answers.rewardsConfig.creatorReward),
+        ...answers.rewardsConfig.creatorAdmin ? {
+          creatorAdmin: toHexAddress(answers.rewardsConfig.creatorAdmin)
+        } : {},
+        ...answers.rewardsConfig.creatorRewardRecipient ? {
+          creatorRewardRecipient: toHexAddress(answers.rewardsConfig.creatorRewardRecipient)
+        } : {},
+        ...answers.rewardsConfig.interfaceAdmin ? {
+          interfaceAdmin: toHexAddress(answers.rewardsConfig.interfaceAdmin)
+        } : {},
+        ...answers.rewardsConfig.interfaceRewardRecipient ? {
+          interfaceRewardRecipient: toHexAddress(answers.rewardsConfig.interfaceRewardRecipient)
+        } : {}
       }
     };
   }
@@ -1251,11 +1364,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
       symbol: answers.symbol,
       salt: answers.salt || "0x0000000000000000000000000000000000000000000000000000000000000000",
       image: answers.image,
-      metadata: {
-        description: `${answers.name} token deployed via Clanker CLI`,
-        socialMediaUrls: [],
-        auditUrls: []
-      },
+      metadata: answers.metadata,
       context: {
         interface: "Clanker CLI",
         platform: "Clanker",
@@ -1269,16 +1378,37 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
       pool: {
         quoteToken,
         initialMarketCap: answers.initialMarketCapUsd
-        // Pass raw value, SDK will handle decimals
       },
       devBuy: answers.devBuy.ethAmount !== "0" ? {
         ethAmount: answers.devBuy.ethAmount,
         maxSlippage: answers.devBuy.maxSlippage
-      } : void 0
+      } : void 0,
+      rewardsConfig: {
+        creatorReward: answers.rewardsConfig.creatorReward === "CUSTOM" ? Number(answers.rewardsConfig.customCreatorReward) : Number(answers.rewardsConfig.creatorReward),
+        ...answers.rewardsConfig.creatorAdmin ? {
+          creatorAdmin: toHexAddress(answers.rewardsConfig.creatorAdmin)
+        } : {},
+        ...answers.rewardsConfig.creatorRewardRecipient ? {
+          creatorRewardRecipient: toHexAddress(answers.rewardsConfig.creatorRewardRecipient)
+        } : {},
+        ...answers.rewardsConfig.interfaceAdmin ? {
+          interfaceAdmin: toHexAddress(answers.rewardsConfig.interfaceAdmin)
+        } : {},
+        ...answers.rewardsConfig.interfaceRewardRecipient ? {
+          interfaceRewardRecipient: toHexAddress(answers.rewardsConfig.interfaceRewardRecipient)
+        } : {}
+      }
     });
+    console.log("\n\u2728 Deployment successful!");
+    console.log(`\u{1F4CD} Token address: ${tokenAddress}`);
+    console.log("\n\u{1F310} View on:");
+    console.log(`Basescan: https://basescan.org/token/${tokenAddress}`);
+    console.log(`Clanker World: https://clanker.world/clanker/${tokenAddress}`);
     return tokenAddress;
   }
   async function main2() {
+    console.clear();
+    console.log(ASCII_ART);
     console.log("\n\u{1F680} Welcome to the Clanker Token Creator! \u{1F680}\n");
     if (!checkEnvironment()) {
       process.exit(1);
@@ -1292,23 +1422,22 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
           type: "confirm",
           name: "confirm",
           message: "Would you like to proceed with deployment?",
-          default: false
+          default: false,
+          prefix: ""
         }
       ]);
       if (confirm) {
         console.log("\n\u{1F504} Deploying your token...");
         try {
           const tokenAddress = await deployToken(answers);
-          console.log("\n\u2728 Token deployed successfully!");
-          console.log("\u{1F4CD} Token address:", tokenAddress);
-          console.log("\n\u{1F310} View on Basescan:");
-          console.log(`https://basescan.org/token/${tokenAddress}`);
+          process.exit(0);
         } catch (error) {
           console.error("\n\u274C Deployment failed:", error instanceof Error ? error.message : "Unknown error");
           process.exit(1);
         }
       } else {
         console.log("\n\u274C Deployment cancelled");
+        process.exit(0);
       }
     } catch (error) {
       console.error("\n\u274C Error:", error);
@@ -1317,21 +1446,23 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
   }
   await main2();
 }
+var ASCII_ART, create_clanker_default;
 var init_create_clanker = __esm({
   "src/cli/create-clanker.ts"() {
     "use strict";
     init_esm_shims();
     init_index();
     dotenv.config();
-    createClanker();
+    ASCII_ART = fs.readFileSync(path2.join(__dirname, "ascii.txt"), "utf8");
+    create_clanker_default = createClanker;
   }
 });
 
 // src/cli/cli.ts
 init_esm_shims();
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { dirname } from "path";
-var __filename2 = fileURLToPath(import.meta.url);
+var __filename2 = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname(__filename2);
 async function main() {
   const args = process.argv.slice(2);

package/dist/cli/create-clanker.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function createClanker(): Promise<void>;
+
+export { createClanker as default };

package/dist/cli/create-clanker.js

@@ -1,5 +1,12 @@
 #!/usr/bin/env node
 
+// node_modules/tsup/assets/esm_shims.js
+import { fileURLToPath } from "url";
+import path from "path";
+var getFilename = () => fileURLToPath(import.meta.url);
+var getDirname = () => path.dirname(getFilename());
+var __dirname = /* @__PURE__ */ getDirname();
+
 // src/cli/create-clanker.ts
 import inquirer from "inquirer";
 
@@ -779,7 +786,14 @@ var Clanker = class {
       tokenConfig: {
         name: cfg.name,
         symbol: cfg.symbol,
-        salt: cfg.salt || "0x0000000000000000000000000000000000000000000000000000000000000000",
+        salt: (() => {
+          const defaultSalt = "0x0000000000000000000000000000000000000000000000000000000000000000";
+          const salt = cfg.salt ?? defaultSalt;
+          if (!/^0x[a-fA-F0-9]{64}$/.test(salt)) {
+            throw new Error("Salt must be a valid bytes32 value (0x + 64 hex characters)");
+          }
+          return salt;
+        })(),
         image: cfg.image || "https://ipfs.io/ipfs/QmcjfTeK3tpK3MVCQuvEaXvSscrqbL3MwsEo8LdBTWabY4",
         metadata: JSON.stringify(cfg.metadata || {
           description: "Clanker Token",
@@ -808,12 +822,17 @@ var Clanker = class {
       },
       initialBuyConfig,
       rewardsConfig: {
-        creatorReward: BigInt(40),
-        // Default to 40% creator reward
-        creatorAdmin: deployerAddress,
-        creatorRewardRecipient: deployerAddress,
-        interfaceAdmin: deployerAddress,
-        interfaceRewardRecipient: deployerAddress
+        creatorReward: (() => {
+          const reward = cfg.rewardsConfig?.creatorReward ?? 80;
+          if (reward < 0 || reward > 80) {
+            throw new Error("Creator reward must be between 0 and 80");
+          }
+          return BigInt(reward);
+        })(),
+        creatorAdmin: cfg.rewardsConfig?.creatorAdmin ?? deployerAddress,
+        creatorRewardRecipient: cfg.rewardsConfig?.creatorRewardRecipient ?? deployerAddress,
+        interfaceAdmin: cfg.rewardsConfig?.interfaceAdmin ?? deployerAddress,
+        interfaceRewardRecipient: cfg.rewardsConfig?.interfaceRewardRecipient ?? deployerAddress
       }
     };
   }
@@ -863,22 +882,20 @@ import { createPublicClient, createWalletClient, http } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 import { base } from "viem/chains";
 import * as dotenv from "dotenv";
+import * as fs from "fs";
+import * as path2 from "path";
 dotenv.config();
+var ASCII_ART = fs.readFileSync(path2.join(__dirname, "ascii.txt"), "utf8");
 async function createClanker() {
-  const args = process.argv.slice(2);
-  if (args.length === 0 || args[0] !== "--create" && args[0] !== "create") {
-    console.log("\n\u{1F680} Clanker SDK CLI\n");
-    console.log("Available commands:");
-    console.log("  --create    Create a new token");
-    console.log("\nExample:");
-    console.log("  npx clanker-sdk --create\n");
-    process.exit(0);
-  }
   const PRIVATE_KEY = process.env.PRIVATE_KEY;
   const FACTORY_ADDRESS = process.env.FACTORY_ADDRESS;
   const RPC_URL = process.env.RPC_URL;
   const WETH_ADDRESS2 = "0x4200000000000000000000000000000000000006";
   const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+  function toHexAddress(address) {
+    if (!address) return void 0;
+    return address.toLowerCase();
+  }
   function checkEnvironment() {
     const missingVars = [];
     if (!PRIVATE_KEY) missingVars.push("PRIVATE_KEY");
@@ -926,8 +943,8 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
   };
   const validateSymbol = (input) => {
     if (!input) return "Symbol cannot be empty";
-    if (!/^[A-Z0-9]+$/.test(input)) return "Symbol must contain only uppercase letters and numbers";
-    if (input.length > 10) return "Symbol must be 10 characters or less";
+    if (!/^[a-zA-Z0-9]+$/.test(input)) return "Symbol must contain only letters and numbers";
+    if (input.length > 20) return "Symbol must be 20 characters or less";
     return true;
   };
   const validateIpfsUri = (input) => {
@@ -984,18 +1001,21 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "name",
         message: "Token name:",
+        prefix: "",
         validate: (input) => input.length > 0 || "Name cannot be empty"
       },
       {
         type: "input",
         name: "symbol",
         message: "Token symbol:",
+        prefix: "",
         validate: validateSymbol
       },
       {
         type: "list",
         name: "pairedTokenChoice",
         message: "Select quote token:",
+        prefix: "",
         choices: [
           { name: "WETH", value: "WETH" },
           { name: "USDC", value: "USDC" },
@@ -1007,6 +1027,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customPairedToken",
         message: "Enter custom token address:",
+        prefix: "",
         validate: validateAddress,
         when: (answers2) => answers2.pairedTokenChoice === "CUSTOM"
       },
@@ -1014,6 +1035,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "initialMarketCapUsd",
         message: (answers2) => `Enter initial market cap in ${answers2.pairedTokenChoice === "CUSTOM" ? "quote token" : answers2.pairedTokenChoice}:`,
+        prefix: "",
         validate: validateAmount,
         default: (answers2) => answers2.pairedTokenChoice === "WETH" ? "1" : answers2.pairedTokenChoice === "USDC" ? "1000" : "1"
       },
@@ -1021,6 +1043,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customMarketCap",
         message: "Enter custom market cap in quote token:",
+        prefix: "",
         validate: validateAmount,
         when: (answers2) => answers2.initialMarketCapUsd === "CUSTOM"
       },
@@ -1028,12 +1051,14 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "image",
         message: "Enter the IPFS URI for the token image:",
+        prefix: "",
         validate: validateIpfsUri
       },
       {
         type: "list",
         name: "devBuy.ethAmount",
         message: "Creator buy amount (optional):",
+        prefix: "",
         choices: [
           { name: "None", value: "0" },
           { name: "0.00005 ETH", value: "0.00005" },
@@ -1048,6 +1073,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customDevBuy",
         message: "Enter custom dev buy amount in ETH:",
+        prefix: "",
         validate: validateAmount,
         when: (answers2) => answers2.devBuy.ethAmount === "CUSTOM"
       },
@@ -1055,6 +1081,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "devBuy.maxSlippage",
         message: "Maximum slippage percentage (0-100):",
+        prefix: "",
         validate: validateSlippage,
         default: "5",
         when: (answers2) => answers2.devBuy.ethAmount !== "0"
@@ -1063,6 +1090,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "list",
         name: "vaultConfig.vaultPercentage",
         message: "Vault percentage (optional):",
+        prefix: "",
         choices: [
           { name: "None", value: "0" },
           { name: "5%", value: "5" },
@@ -1076,6 +1104,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customVaultPercentage",
         message: "Enter custom vault percentage (0-30):",
+        prefix: "",
         validate: validateVaultPercentage,
         when: (answers2) => answers2.vaultConfig.vaultPercentage === "CUSTOM"
       },
@@ -1083,6 +1112,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "list",
         name: "vaultConfig.durationInDays",
         message: "Vault duration:",
+        prefix: "",
         choices: [
           { name: "31 days", value: "31" },
           { name: "90 days", value: "90" },
@@ -1096,6 +1126,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "customVaultDuration",
         message: "Enter custom vault duration in days (minimum 30):",
+        prefix: "",
         validate: validateVaultDuration,
         when: (answers2) => answers2.vaultConfig.durationInDays === "CUSTOM"
       },
@@ -1103,6 +1134,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "metadata.description",
         message: "Token description:",
+        prefix: "",
         default: (answers2) => `${answers2.name} token deployed via Clanker CLI`,
         validate: (input) => input.length > 0 || "Description cannot be empty"
       },
@@ -1110,28 +1142,96 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
         type: "input",
         name: "metadata.telegram",
         message: "Telegram URL (optional):",
+        prefix: "",
         validate: validateUrl
       },
       {
         type: "input",
         name: "metadata.website",
         message: "Website URL (optional):",
+        prefix: "",
         validate: validateUrl
       },
       {
         type: "input",
         name: "metadata.twitter",
         message: "X/Twitter URL (optional):",
+        prefix: "",
         validate: validateUrl
       },
       {
         type: "input",
         name: "metadata.farcaster",
         message: "Farcaster URL (optional):",
+        prefix: "",
         validate: validateUrl
+      },
+      {
+        type: "input",
+        name: "salt",
+        message: "Enter custom salt (optional, press enter for default 0x0000...):",
+        prefix: "",
+        validate: (input) => {
+          if (!input) return true;
+          if (!/^0x[a-fA-F0-9]{64}$/.test(input)) {
+            return "Salt must be a valid bytes32 value (0x + 64 hex characters)";
+          }
+          return true;
+        }
+      },
+      {
+        type: "list",
+        name: "rewardsConfig.creatorReward",
+        message: "Creator reward percentage, balance remaining goes to interface:",
+        prefix: "",
+        choices: [
+          { name: "80% (maximum)", value: 80 },
+          { name: "60%", value: 60 },
+          { name: "40%", value: 40 },
+          { name: "20%", value: 20 },
+          { name: "0% (all to interface)", value: 0 },
+          { name: "Custom", value: "CUSTOM" }
+        ],
+        default: 80
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.customCreatorReward",
+        message: "Enter custom creator reward percentage (0-80):",
+        prefix: "",
+        validate: validateCreatorReward,
+        when: (answers2) => answers2.rewardsConfig.creatorReward === "CUSTOM"
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.creatorAdmin",
+        message: "Enter custom creator admin address (optional):",
+        prefix: "",
+        validate: validateAddress
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.creatorRewardRecipient",
+        message: "Enter custom creator reward recipient address (optional):",
+        prefix: "",
+        validate: validateAddress
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.interfaceAdmin",
+        message: "Enter custom interface admin address (optional):",
+        prefix: "",
+        validate: validateAddress
+      },
+      {
+        type: "input",
+        name: "rewardsConfig.interfaceRewardRecipient",
+        message: "Enter custom interface reward recipient address (optional):",
+        prefix: "",
+        validate: validateAddress
       }
     ];
-    const answers = await inquirer.prompt(questions);
+    const answers = await inquirer.prompt(questions, {});
     if (answers.initialMarketCapUsd === "CUSTOM") {
       answers.initialMarketCapUsd = answers.customMarketCap || "0";
     }
@@ -1156,6 +1256,21 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
       vaultConfig: {
         vaultPercentage: vaultPercentage.toString(),
         durationInDays: vaultDuration.toString()
+      },
+      rewardsConfig: {
+        creatorReward: answers.rewardsConfig.creatorReward === "CUSTOM" ? Number(answers.rewardsConfig.customCreatorReward) : Number(answers.rewardsConfig.creatorReward),
+        ...answers.rewardsConfig.creatorAdmin ? {
+          creatorAdmin: toHexAddress(answers.rewardsConfig.creatorAdmin)
+        } : {},
+        ...answers.rewardsConfig.creatorRewardRecipient ? {
+          creatorRewardRecipient: toHexAddress(answers.rewardsConfig.creatorRewardRecipient)
+        } : {},
+        ...answers.rewardsConfig.interfaceAdmin ? {
+          interfaceAdmin: toHexAddress(answers.rewardsConfig.interfaceAdmin)
+        } : {},
+        ...answers.rewardsConfig.interfaceRewardRecipient ? {
+          interfaceRewardRecipient: toHexAddress(answers.rewardsConfig.interfaceRewardRecipient)
+        } : {}
       }
     };
   }
@@ -1204,11 +1319,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
       symbol: answers.symbol,
       salt: answers.salt || "0x0000000000000000000000000000000000000000000000000000000000000000",
       image: answers.image,
-      metadata: {
-        description: `${answers.name} token deployed via Clanker CLI`,
-        socialMediaUrls: [],
-        auditUrls: []
-      },
+      metadata: answers.metadata,
       context: {
         interface: "Clanker CLI",
         platform: "Clanker",
@@ -1222,16 +1333,37 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
       pool: {
         quoteToken,
         initialMarketCap: answers.initialMarketCapUsd
-        // Pass raw value, SDK will handle decimals
       },
       devBuy: answers.devBuy.ethAmount !== "0" ? {
         ethAmount: answers.devBuy.ethAmount,
         maxSlippage: answers.devBuy.maxSlippage
-      } : void 0
+      } : void 0,
+      rewardsConfig: {
+        creatorReward: answers.rewardsConfig.creatorReward === "CUSTOM" ? Number(answers.rewardsConfig.customCreatorReward) : Number(answers.rewardsConfig.creatorReward),
+        ...answers.rewardsConfig.creatorAdmin ? {
+          creatorAdmin: toHexAddress(answers.rewardsConfig.creatorAdmin)
+        } : {},
+        ...answers.rewardsConfig.creatorRewardRecipient ? {
+          creatorRewardRecipient: toHexAddress(answers.rewardsConfig.creatorRewardRecipient)
+        } : {},
+        ...answers.rewardsConfig.interfaceAdmin ? {
+          interfaceAdmin: toHexAddress(answers.rewardsConfig.interfaceAdmin)
+        } : {},
+        ...answers.rewardsConfig.interfaceRewardRecipient ? {
+          interfaceRewardRecipient: toHexAddress(answers.rewardsConfig.interfaceRewardRecipient)
+        } : {}
+      }
     });
+    console.log("\n\u2728 Deployment successful!");
+    console.log(`\u{1F4CD} Token address: ${tokenAddress}`);
+    console.log("\n\u{1F310} View on:");
+    console.log(`Basescan: https://basescan.org/token/${tokenAddress}`);
+    console.log(`Clanker World: https://clanker.world/clanker/${tokenAddress}`);
     return tokenAddress;
   }
   async function main() {
+    console.clear();
+    console.log(ASCII_ART);
     console.log("\n\u{1F680} Welcome to the Clanker Token Creator! \u{1F680}\n");
     if (!checkEnvironment()) {
       process.exit(1);
@@ -1245,23 +1377,22 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
           type: "confirm",
           name: "confirm",
           message: "Would you like to proceed with deployment?",
-          default: false
+          default: false,
+          prefix: ""
         }
       ]);
       if (confirm) {
         console.log("\n\u{1F504} Deploying your token...");
         try {
           const tokenAddress = await deployToken(answers);
-          console.log("\n\u2728 Token deployed successfully!");
-          console.log("\u{1F4CD} Token address:", tokenAddress);
-          console.log("\n\u{1F310} View on Basescan:");
-          console.log(`https://basescan.org/token/${tokenAddress}`);
+          process.exit(0);
         } catch (error) {
           console.error("\n\u274C Deployment failed:", error instanceof Error ? error.message : "Unknown error");
           process.exit(1);
         }
       } else {
         console.log("\n\u274C Deployment cancelled");
+        process.exit(0);
       }
     } catch (error) {
       console.error("\n\u274C Error:", error);
@@ -1270,7 +1401,7 @@ RPC_URL=your_custom_rpc_url (if not provided, will use default Base RPC)
   }
   await main();
 }
-createClanker();
+var create_clanker_default = createClanker;
 export {
-  createClanker as default
+  create_clanker_default as default
 };

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+import { PublicClient, WalletClient, Address } from 'viem';
+
+interface TokenConfig {
+    name: string;
+    symbol: string;
+    salt: `0x${string}`;
+    image: string;
+    metadata: IClankerMetadata;
+    context: IClankerSocialContext;
+    originatingChainId: bigint;
+}
+interface VaultConfig {
+    vaultPercentage: number;
+    vaultDuration: bigint;
+}
+interface PoolConfig {
+    pairedToken: Address;
+    initialMarketCapInPairedToken: bigint;
+    initialMarketCap?: string;
+    tickIfToken0IsNewToken?: number;
+}
+interface InitialBuyConfig {
+    pairedTokenPoolFee: number;
+    pairedTokenSwapAmountOutMinimum: bigint;
+    ethAmount?: bigint;
+}
+interface RewardsConfig {
+    creatorReward: bigint;
+    creatorAdmin: Address;
+    creatorRewardRecipient: Address;
+    interfaceAdmin: Address;
+    interfaceRewardRecipient: Address;
+}
+interface DeploymentConfig {
+    tokenConfig: TokenConfig;
+    vaultConfig?: VaultConfig;
+    poolConfig: PoolConfig;
+    initialBuyConfig?: InitialBuyConfig;
+    rewardsConfig: RewardsConfig;
+}
+type ClankerConfig = {
+    publicClient: PublicClient;
+    wallet?: WalletClient;
+    factoryAddress?: Address;
+};
+interface SimpleTokenConfig {
+    name: string;
+    symbol: string;
+    salt?: `0x${string}`;
+    image?: string;
+    metadata?: {
+        description: string;
+        socialMediaUrls: string[];
+        auditUrls: string[];
+    };
+    context?: {
+        interface: string;
+        platform: string;
+        messageId: string;
+        id: string;
+    };
+    pool?: {
+        quoteToken?: `0x${string}`;
+        initialMarketCap?: string;
+    };
+    vault?: {
+        percentage: number;
+        durationInDays: number;
+    };
+    devBuy?: {
+        ethAmount: string;
+        maxSlippage?: number;
+    };
+    rewardsConfig?: {
+        creatorReward?: number;
+        creatorAdmin?: `0x${string}`;
+        creatorRewardRecipient?: `0x${string}`;
+        interfaceAdmin?: `0x${string}`;
+        interfaceRewardRecipient?: `0x${string}`;
+    };
+}
+interface IClankerMetadata {
+    description?: string;
+    socialMediaUrls?: {
+        platform: string;
+        url: string;
+    }[];
+    auditUrls?: string[];
+}
+interface IClankerSocialContext {
+    interface: string;
+    platform?: string;
+    messageId?: string;
+    id?: string;
+}
+
+/** Lightweight container for a pre-built deploy transaction */
+type PreparedDeployTx = {
+    to: Address;
+    data: `0x${string}`;
+    value: bigint;
+};
+declare class Clanker {
+    private readonly wallet?;
+    private readonly factoryAddress;
+    private readonly publicClient;
+    constructor(config: ClankerConfig);
+    private getQuoteTokenDecimals;
+    private findMostLiquidPool;
+    private calculateMinimumOutput;
+    private calculateTickForQuoteToken;
+    private handleError;
+    deploy(config: DeploymentConfig): Promise<Address>;
+    private buildDeploymentConfig;
+    /**
+     * Creates calldata (+ msg.value) **without** sending a transaction.
+     * This version no longer relies on viem's `simulateContract`, which
+     * was returning an object without `.data`.  We now ABI-encode the
+     * call manually so `data` is always defined.
+     */
+    prepareDeployToken(cfg: SimpleTokenConfig): Promise<PreparedDeployTx>;
+    deployToken(cfg: SimpleTokenConfig): Promise<Address>;
+}
+
+export { Clanker, type ClankerConfig, type DeploymentConfig, type IClankerMetadata, type IClankerSocialContext, type InitialBuyConfig, type PoolConfig, type PreparedDeployTx, type RewardsConfig, type SimpleTokenConfig, type TokenConfig, type VaultConfig };

package/dist/index.js

@@ -774,7 +774,14 @@ var Clanker = class {
       tokenConfig: {
         name: cfg.name,
         symbol: cfg.symbol,
-        salt: cfg.salt || "0x0000000000000000000000000000000000000000000000000000000000000000",
+        salt: (() => {
+          const defaultSalt = "0x0000000000000000000000000000000000000000000000000000000000000000";
+          const salt = cfg.salt ?? defaultSalt;
+          if (!/^0x[a-fA-F0-9]{64}$/.test(salt)) {
+            throw new Error("Salt must be a valid bytes32 value (0x + 64 hex characters)");
+          }
+          return salt;
+        })(),
         image: cfg.image || "https://ipfs.io/ipfs/QmcjfTeK3tpK3MVCQuvEaXvSscrqbL3MwsEo8LdBTWabY4",
         metadata: JSON.stringify(cfg.metadata || {
           description: "Clanker Token",
@@ -803,12 +810,17 @@ var Clanker = class {
       },
       initialBuyConfig,
       rewardsConfig: {
-        creatorReward: BigInt(40),
-        // Default to 40% creator reward
-        creatorAdmin: deployerAddress,
-        creatorRewardRecipient: deployerAddress,
-        interfaceAdmin: deployerAddress,
-        interfaceRewardRecipient: deployerAddress
+        creatorReward: (() => {
+          const reward = cfg.rewardsConfig?.creatorReward ?? 80;
+          if (reward < 0 || reward > 80) {
+            throw new Error("Creator reward must be between 0 and 80");
+          }
+          return BigInt(reward);
+        })(),
+        creatorAdmin: cfg.rewardsConfig?.creatorAdmin ?? deployerAddress,
+        creatorRewardRecipient: cfg.rewardsConfig?.creatorRewardRecipient ?? deployerAddress,
+        interfaceAdmin: cfg.rewardsConfig?.interfaceAdmin ?? deployerAddress,
+        interfaceRewardRecipient: cfg.rewardsConfig?.interfaceRewardRecipient ?? deployerAddress
       }
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clanker-sdk",
-  "version": "3.9.8",
+  "version": "3.9.9",
   "description": "SDK for deploying tokens using Clanker",
   "type": "module",
   "main": "./dist/index.js",