@manifest-network/manifest-mcp-browser 0.1.1 → 0.1.6

package/src/transactions/distribution.ts

@@ -1,7 +1,8 @@
 import { SigningStargateClient } from '@cosmjs/stargate';
 import { cosmos } from '@manifest-network/manifestjs';
-import { ManifestMCPError, ManifestMCPErrorCode, CosmosTxResult, ManifestMCPConfig } from '../types.js';
-import { parseAmount, buildTxResult, validateAddress, validateArgsLength } from './utils.js';
+import { CosmosTxResult } from '../types.js';
+import { throwUnsupportedSubcommand } from '../modules.js';
+import { parseAmount, buildTxResult, validateAddress, validateArgsLength, requireArgs } from './utils.js';
 
 const { MsgWithdrawDelegatorReward, MsgSetWithdrawAddress, MsgFundCommunityPool } = cosmos.distribution.v1beta1;
 
@@ -13,20 +14,13 @@ export async function routeDistributionTransaction(
   senderAddress: string,
   subcommand: string,
   args: string[],
-  _config: ManifestMCPConfig,
   waitForConfirmation: boolean
 ): Promise<CosmosTxResult> {
   validateArgsLength(args, 'distribution transaction');
 
   switch (subcommand) {
     case 'withdraw-rewards': {
-      if (args.length < 1) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'withdraw-rewards requires validator-address argument'
-        );
-      }
-
+      requireArgs(args, 1, ['validator-address'], 'distribution withdraw-rewards');
       const [validatorAddress] = args;
       validateAddress(validatorAddress, 'validator address');
 
@@ -43,13 +37,7 @@ export async function routeDistributionTransaction(
     }
 
     case 'set-withdraw-addr': {
-      if (args.length < 1) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'set-withdraw-addr requires withdraw-address argument'
-        );
-      }
-
+      requireArgs(args, 1, ['withdraw-address'], 'distribution set-withdraw-addr');
       const [withdrawAddress] = args;
       validateAddress(withdrawAddress, 'withdraw address');
 
@@ -66,13 +54,7 @@ export async function routeDistributionTransaction(
     }
 
     case 'fund-community-pool': {
-      if (args.length < 1) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'fund-community-pool requires amount argument'
-        );
-      }
-
+      requireArgs(args, 1, ['amount'], 'distribution fund-community-pool');
       const [amountStr] = args;
       const { amount, denom } = parseAmount(amountStr);
 
@@ -89,10 +71,6 @@ export async function routeDistributionTransaction(
     }
 
     default:
-      throw new ManifestMCPError(
-        ManifestMCPErrorCode.UNSUPPORTED_TX,
-        `Unsupported distribution transaction subcommand: ${subcommand}`,
-        { availableSubcommands: ['withdraw-rewards', 'set-withdraw-addr', 'fund-community-pool'] }
-      );
+      throwUnsupportedSubcommand('tx', 'distribution', subcommand);
   }
 }

package/src/transactions/gov.ts

@@ -1,10 +1,34 @@
 import { SigningStargateClient } from '@cosmjs/stargate';
 import { cosmos } from '@manifest-network/manifestjs';
-import { ManifestMCPError, ManifestMCPErrorCode, CosmosTxResult, ManifestMCPConfig } from '../types.js';
-import { parseAmount, buildTxResult, parseBigInt, validateArgsLength } from './utils.js';
+import { ManifestMCPError, ManifestMCPErrorCode, CosmosTxResult } from '../types.js';
+import { throwUnsupportedSubcommand } from '../modules.js';
+import { parseAmount, buildTxResult, parseBigInt, validateArgsLength, extractFlag, requireArgs } from './utils.js';
 
 const { MsgVote, MsgDeposit, MsgVoteWeighted, VoteOption } = cosmos.gov.v1;
 
+/** 10^18 as BigInt for fixed-point math */
+const FIXED18_ONE = BigInt('1000000000000000000');
+
+/**
+ * Format a fixed-18 BigInt as a decimal string without precision loss.
+ * E.g., 500000000000000000n -> "0.5", 1000000000000000000n -> "1.0"
+ */
+function formatFixed18(value: bigint): string {
+  const isNegative = value < BigInt(0);
+  const absValue = isNegative ? -value : value;
+  const intPart = absValue / FIXED18_ONE;
+  const fracPart = absValue % FIXED18_ONE;
+
+  // Pad fraction to 18 digits, then trim trailing zeros
+  const fracStr = fracPart.toString().padStart(18, '0').replace(/0+$/, '');
+
+  const sign = isNegative ? '-' : '';
+  if (fracStr === '') {
+    return `${sign}${intPart}.0`;
+  }
+  return `${sign}${intPart}.${fracStr}`;
+}
+
 /**
  * Parse a decimal weight string to an 18-decimal fixed-point string.
  * Uses string manipulation to avoid floating-point precision loss.
@@ -70,30 +94,19 @@ export async function routeGovTransaction(
   senderAddress: string,
   subcommand: string,
   args: string[],
-  _config: ManifestMCPConfig,
   waitForConfirmation: boolean
 ): Promise<CosmosTxResult> {
   validateArgsLength(args, 'gov transaction');
 
   switch (subcommand) {
     case 'vote': {
-      if (args.length < 2) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'vote requires proposal-id and option arguments'
-        );
-      }
-
+      requireArgs(args, 2, ['proposal-id', 'option'], 'gov vote');
       const [proposalIdStr, optionStr] = args;
       const proposalId = parseBigInt(proposalIdStr, 'proposal-id');
       const option = parseVoteOption(optionStr);
 
       // Extract optional metadata from args
-      let metadata = '';
-      const metadataIndex = args.indexOf('--metadata');
-      if (metadataIndex !== -1 && args[metadataIndex + 1]) {
-        metadata = args[metadataIndex + 1];
-      }
+      const { value: metadata = '' } = extractFlag(args, '--metadata', 'gov vote');
 
       const msg = {
         typeUrl: '/cosmos.gov.v1.MsgVote',
@@ -110,13 +123,7 @@ export async function routeGovTransaction(
     }
 
     case 'weighted-vote': {
-      if (args.length < 2) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'weighted-vote requires proposal-id and options arguments (format: yes=0.5,no=0.5)'
-        );
-      }
-
+      requireArgs(args, 2, ['proposal-id', 'options'], 'gov weighted-vote');
       const [proposalIdStr, optionsStr] = args;
       const proposalId = parseBigInt(proposalIdStr, 'proposal-id');
 
@@ -138,11 +145,10 @@ export async function routeGovTransaction(
 
       // Validate that weights sum to exactly 1.0 (10^18 in fixed-point)
       const totalWeight = options.reduce((sum, opt) => sum + BigInt(opt.weight), BigInt(0));
-      const oneInFixed18 = BigInt('1000000000000000000'); // 10^18
-      if (totalWeight !== oneInFixed18) {
+      if (totalWeight !== FIXED18_ONE) {
         throw new ManifestMCPError(
           ManifestMCPErrorCode.TX_FAILED,
-          `Weighted vote options must sum to exactly 1.0. Got ${Number(totalWeight) / 1e18} (${options.map(o => o.weight).join(' + ')} = ${totalWeight})`
+          `Weighted vote options must sum to exactly 1.0. Got ${formatFixed18(totalWeight)} (${options.map(o => o.weight).join(' + ')} = ${totalWeight})`
         );
       }
 
@@ -161,13 +167,7 @@ export async function routeGovTransaction(
     }
 
     case 'deposit': {
-      if (args.length < 2) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'deposit requires proposal-id and amount arguments'
-        );
-      }
-
+      requireArgs(args, 2, ['proposal-id', 'amount'], 'gov deposit');
       const [proposalIdStr, amountStr] = args;
       const proposalId = parseBigInt(proposalIdStr, 'proposal-id');
       const { amount, denom } = parseAmount(amountStr);
@@ -186,10 +186,6 @@ export async function routeGovTransaction(
     }
 
     default:
-      throw new ManifestMCPError(
-        ManifestMCPErrorCode.UNSUPPORTED_TX,
-        `Unsupported gov transaction subcommand: ${subcommand}`,
-        { availableSubcommands: ['vote', 'weighted-vote', 'deposit'] }
-      );
+      throwUnsupportedSubcommand('tx', 'gov', subcommand);
   }
 }

package/src/transactions/index.ts

@@ -1,4 +1,4 @@
-export { parseAmount, buildTxResult, parseBigInt } from './utils.js';
+export { parseAmount, buildTxResult, parseBigInt, parseHexBytes, bytesToHex } from './utils.js';
 export { routeBankTransaction } from './bank.js';
 export { routeStakingTransaction } from './staking.js';
 export { routeDistributionTransaction } from './distribution.js';

package/src/transactions/manifest.ts

@@ -1,7 +1,8 @@
 import { SigningStargateClient } from '@cosmjs/stargate';
 import { liftedinit } from '@manifest-network/manifestjs';
-import { ManifestMCPError, ManifestMCPErrorCode, CosmosTxResult, ManifestMCPConfig } from '../types.js';
-import { parseAmount, buildTxResult, validateAddress, validateArgsLength } from './utils.js';
+import { CosmosTxResult } from '../types.js';
+import { throwUnsupportedSubcommand } from '../modules.js';
+import { parseAmount, buildTxResult, validateAddress, validateArgsLength, parseColonPair, requireArgs } from './utils.js';
 
 const { MsgPayout, MsgBurnHeldBalance } = liftedinit.manifest.v1;
 
@@ -13,29 +14,16 @@ export async function routeManifestTransaction(
   senderAddress: string,
   subcommand: string,
   args: string[],
-  _config: ManifestMCPConfig,
   waitForConfirmation: boolean
 ): Promise<CosmosTxResult> {
   validateArgsLength(args, 'manifest transaction');
 
   switch (subcommand) {
     case 'payout': {
-      if (args.length < 1) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'payout requires at least one address:amount pair'
-        );
-      }
-
+      requireArgs(args, 1, ['address:amount'], 'manifest payout');
       // Parse payout pairs (format: address:amount ...)
       const payoutPairs = args.map((arg) => {
-        const [address, amountStr] = arg.split(':');
-        if (!address || !amountStr) {
-          throw new ManifestMCPError(
-            ManifestMCPErrorCode.TX_FAILED,
-            `Invalid payout pair format: ${arg}. Expected format: address:amount`
-          );
-        }
+        const [address, amountStr] = parseColonPair(arg, 'address', 'amount', 'payout pair');
         validateAddress(address, 'payout recipient address');
         const { amount, denom } = parseAmount(amountStr);
         return { address, coin: { denom, amount } };
@@ -54,13 +42,7 @@ export async function routeManifestTransaction(
     }
 
     case 'burn-held-balance': {
-      if (args.length < 1) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'burn-held-balance requires at least one amount argument'
-        );
-      }
-
+      requireArgs(args, 1, ['amount'], 'manifest burn-held-balance');
       // Parse coins to burn
       const burnCoins = args.map((amountStr) => {
         const { amount, denom } = parseAmount(amountStr);
@@ -80,10 +62,6 @@ export async function routeManifestTransaction(
     }
 
     default:
-      throw new ManifestMCPError(
-        ManifestMCPErrorCode.UNSUPPORTED_TX,
-        `Unsupported manifest transaction subcommand: ${subcommand}`,
-        { availableSubcommands: ['payout', 'burn-held-balance'] }
-      );
+      throwUnsupportedSubcommand('tx', 'manifest', subcommand);
   }
 }

package/src/transactions/sku.ts

@@ -0,0 +1,232 @@
+import { SigningStargateClient } from '@cosmjs/stargate';
+import { liftedinit } from '@manifest-network/manifestjs';
+import { CosmosTxResult, ManifestMCPError, ManifestMCPErrorCode } from '../types.js';
+import { parseAmount, buildTxResult, validateAddress, validateArgsLength, extractFlag, filterConsumedArgs, requireArgs, parseHexBytes, MAX_META_HASH_BYTES } from './utils.js';
+import { throwUnsupportedSubcommand } from '../modules.js';
+
+const {
+  MsgCreateProvider, MsgUpdateProvider, MsgDeactivateProvider,
+  MsgCreateSKU, MsgUpdateSKU, MsgDeactivateSKU,
+  MsgUpdateParams,
+  Unit,
+} = liftedinit.sku.v1;
+
+/**
+ * Parse a unit string to the Unit enum value.
+ * Accepts 'per-hour' or 'per-day'.
+ */
+function parseUnit(value: string): number {
+  switch (value.toLowerCase()) {
+    case 'per-hour':
+      return Unit.UNIT_PER_HOUR;
+    case 'per-day':
+      return Unit.UNIT_PER_DAY;
+    default:
+      throw new ManifestMCPError(
+        ManifestMCPErrorCode.TX_FAILED,
+        `Invalid unit: "${value}". Expected "per-hour" or "per-day".`
+      );
+  }
+}
+
+/**
+ * Parse a boolean string ('true' or 'false').
+ */
+function parseBooleanString(value: string, fieldName: string): boolean {
+  const lower = value.toLowerCase();
+  if (lower === 'true') return true;
+  if (lower === 'false') return false;
+  throw new ManifestMCPError(
+    ManifestMCPErrorCode.TX_FAILED,
+    `Invalid ${fieldName}: "${value}". Expected "true" or "false".`
+  );
+}
+
+/**
+ * Route SKU transaction to appropriate handler
+ */
+export async function routeSkuTransaction(
+  client: SigningStargateClient,
+  senderAddress: string,
+  subcommand: string,
+  args: string[],
+  waitForConfirmation: boolean
+): Promise<CosmosTxResult> {
+  validateArgsLength(args, 'sku transaction');
+
+  switch (subcommand) {
+    case 'create-provider': {
+      // Parse optional --meta-hash flag
+      const { value: metaHashHex, consumedIndices } = extractFlag(args, '--meta-hash', 'sku create-provider');
+      const metaHash = metaHashHex ? parseHexBytes(metaHashHex, 'meta-hash', MAX_META_HASH_BYTES) : new Uint8Array();
+      const positionalArgs = filterConsumedArgs(args, consumedIndices);
+
+      requireArgs(positionalArgs, 3, ['address', 'payout-address', 'api-url'], 'sku create-provider');
+      const [address, payoutAddress, apiUrl] = positionalArgs;
+      validateAddress(address, 'address');
+      validateAddress(payoutAddress, 'payout address');
+
+      const msg = {
+        typeUrl: '/liftedinit.sku.v1.MsgCreateProvider',
+        value: MsgCreateProvider.fromPartial({
+          authority: senderAddress,
+          address,
+          payoutAddress,
+          metaHash,
+          apiUrl,
+        }),
+      };
+
+      const result = await client.signAndBroadcast(senderAddress, [msg], 'auto');
+      return buildTxResult('sku', 'create-provider', result, waitForConfirmation);
+    }
+
+    case 'update-provider': {
+      // Parse optional flags
+      const metaHashFlag = extractFlag(args, '--meta-hash', 'sku update-provider');
+      const activeFlag = extractFlag(args, '--active', 'sku update-provider');
+      const allConsumed = [...metaHashFlag.consumedIndices, ...activeFlag.consumedIndices];
+      const positionalArgs = filterConsumedArgs(args, allConsumed);
+
+      requireArgs(positionalArgs, 4, ['provider-uuid', 'address', 'payout-address', 'api-url'], 'sku update-provider');
+      const [uuid, address, payoutAddress, apiUrl] = positionalArgs;
+      validateAddress(address, 'address');
+      validateAddress(payoutAddress, 'payout address');
+
+      const metaHash = metaHashFlag.value ? parseHexBytes(metaHashFlag.value, 'meta-hash', MAX_META_HASH_BYTES) : new Uint8Array();
+      const active = activeFlag.value ? parseBooleanString(activeFlag.value, 'active') : true;
+
+      const msg = {
+        typeUrl: '/liftedinit.sku.v1.MsgUpdateProvider',
+        value: MsgUpdateProvider.fromPartial({
+          authority: senderAddress,
+          uuid,
+          address,
+          payoutAddress,
+          metaHash,
+          active,
+          apiUrl,
+        }),
+      };
+
+      const result = await client.signAndBroadcast(senderAddress, [msg], 'auto');
+      return buildTxResult('sku', 'update-provider', result, waitForConfirmation);
+    }
+
+    case 'deactivate-provider': {
+      requireArgs(args, 1, ['provider-uuid'], 'sku deactivate-provider');
+      const [uuid] = args;
+
+      const msg = {
+        typeUrl: '/liftedinit.sku.v1.MsgDeactivateProvider',
+        value: MsgDeactivateProvider.fromPartial({
+          authority: senderAddress,
+          uuid,
+        }),
+      };
+
+      const result = await client.signAndBroadcast(senderAddress, [msg], 'auto');
+      return buildTxResult('sku', 'deactivate-provider', result, waitForConfirmation);
+    }
+
+    case 'create-sku': {
+      // Parse optional --meta-hash flag
+      const { value: metaHashHex, consumedIndices } = extractFlag(args, '--meta-hash', 'sku create-sku');
+      const metaHash = metaHashHex ? parseHexBytes(metaHashHex, 'meta-hash', MAX_META_HASH_BYTES) : new Uint8Array();
+      const positionalArgs = filterConsumedArgs(args, consumedIndices);
+
+      requireArgs(positionalArgs, 4, ['provider-uuid', 'name', 'unit', 'base-price'], 'sku create-sku');
+      const [providerUuid, name, unitStr, basePriceStr] = positionalArgs;
+
+      const unit = parseUnit(unitStr);
+      const { amount, denom } = parseAmount(basePriceStr);
+
+      const msg = {
+        typeUrl: '/liftedinit.sku.v1.MsgCreateSKU',
+        value: MsgCreateSKU.fromPartial({
+          authority: senderAddress,
+          providerUuid,
+          name,
+          unit,
+          basePrice: { denom, amount },
+          metaHash,
+        }),
+      };
+
+      const result = await client.signAndBroadcast(senderAddress, [msg], 'auto');
+      return buildTxResult('sku', 'create-sku', result, waitForConfirmation);
+    }
+
+    case 'update-sku': {
+      // Parse optional flags
+      const metaHashFlag = extractFlag(args, '--meta-hash', 'sku update-sku');
+      const activeFlag = extractFlag(args, '--active', 'sku update-sku');
+      const allConsumed = [...metaHashFlag.consumedIndices, ...activeFlag.consumedIndices];
+      const positionalArgs = filterConsumedArgs(args, allConsumed);
+
+      requireArgs(positionalArgs, 5, ['sku-uuid', 'provider-uuid', 'name', 'unit', 'base-price'], 'sku update-sku');
+      const [uuid, providerUuid, name, unitStr, basePriceStr] = positionalArgs;
+
+      const unit = parseUnit(unitStr);
+      const { amount, denom } = parseAmount(basePriceStr);
+      const metaHash = metaHashFlag.value ? parseHexBytes(metaHashFlag.value, 'meta-hash', MAX_META_HASH_BYTES) : new Uint8Array();
+      const active = activeFlag.value ? parseBooleanString(activeFlag.value, 'active') : true;
+
+      const msg = {
+        typeUrl: '/liftedinit.sku.v1.MsgUpdateSKU',
+        value: MsgUpdateSKU.fromPartial({
+          authority: senderAddress,
+          uuid,
+          providerUuid,
+          name,
+          unit,
+          basePrice: { denom, amount },
+          metaHash,
+          active,
+        }),
+      };
+
+      const result = await client.signAndBroadcast(senderAddress, [msg], 'auto');
+      return buildTxResult('sku', 'update-sku', result, waitForConfirmation);
+    }
+
+    case 'deactivate-sku': {
+      requireArgs(args, 1, ['sku-uuid'], 'sku deactivate-sku');
+      const [uuid] = args;
+
+      const msg = {
+        typeUrl: '/liftedinit.sku.v1.MsgDeactivateSKU',
+        value: MsgDeactivateSKU.fromPartial({
+          authority: senderAddress,
+          uuid,
+        }),
+      };
+
+      const result = await client.signAndBroadcast(senderAddress, [msg], 'auto');
+      return buildTxResult('sku', 'deactivate-sku', result, waitForConfirmation);
+    }
+
+    case 'update-params': {
+      requireArgs(args, 1, ['allowed-address'], 'sku update-params');
+      for (const addr of args) {
+        validateAddress(addr, 'allowed address');
+      }
+
+      const msg = {
+        typeUrl: '/liftedinit.sku.v1.MsgUpdateParams',
+        value: MsgUpdateParams.fromPartial({
+          authority: senderAddress,
+          params: {
+            allowedList: args,
+          },
+        }),
+      };
+
+      const result = await client.signAndBroadcast(senderAddress, [msg], 'auto');
+      return buildTxResult('sku', 'update-params', result, waitForConfirmation);
+    }
+
+    default:
+      throwUnsupportedSubcommand('tx', 'sku', subcommand);
+  }
+}

package/src/transactions/staking.ts

@@ -1,7 +1,8 @@
 import { SigningStargateClient } from '@cosmjs/stargate';
 import { cosmos } from '@manifest-network/manifestjs';
-import { ManifestMCPError, ManifestMCPErrorCode, CosmosTxResult, ManifestMCPConfig } from '../types.js';
-import { parseAmount, buildTxResult, validateAddress, validateArgsLength } from './utils.js';
+import { CosmosTxResult } from '../types.js';
+import { throwUnsupportedSubcommand } from '../modules.js';
+import { parseAmount, buildTxResult, validateAddress, validateArgsLength, requireArgs } from './utils.js';
 
 const { MsgDelegate, MsgUndelegate, MsgBeginRedelegate } = cosmos.staking.v1beta1;
 
@@ -13,20 +14,13 @@ export async function routeStakingTransaction(
   senderAddress: string,
   subcommand: string,
   args: string[],
-  _config: ManifestMCPConfig,
   waitForConfirmation: boolean
 ): Promise<CosmosTxResult> {
   validateArgsLength(args, 'staking transaction');
 
   switch (subcommand) {
     case 'delegate': {
-      if (args.length < 2) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'delegate requires validator-address and amount arguments'
-        );
-      }
-
+      requireArgs(args, 2, ['validator-address', 'amount'], 'staking delegate');
       const [validatorAddress, amountStr] = args;
       validateAddress(validatorAddress, 'validator address');
       const { amount, denom } = parseAmount(amountStr);
@@ -46,13 +40,7 @@ export async function routeStakingTransaction(
 
     case 'unbond':
     case 'undelegate': {
-      if (args.length < 2) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'unbond requires validator-address and amount arguments'
-        );
-      }
-
+      requireArgs(args, 2, ['validator-address', 'amount'], 'staking unbond');
       const [validatorAddress, amountStr] = args;
       validateAddress(validatorAddress, 'validator address');
       const { amount, denom } = parseAmount(amountStr);
@@ -71,13 +59,7 @@ export async function routeStakingTransaction(
     }
 
     case 'redelegate': {
-      if (args.length < 3) {
-        throw new ManifestMCPError(
-          ManifestMCPErrorCode.TX_FAILED,
-          'redelegate requires src-validator, dst-validator, and amount arguments'
-        );
-      }
-
+      requireArgs(args, 3, ['src-validator', 'dst-validator', 'amount'], 'staking redelegate');
       const [srcValidatorAddress, dstValidatorAddress, amountStr] = args;
       validateAddress(srcValidatorAddress, 'source validator address');
       validateAddress(dstValidatorAddress, 'destination validator address');
@@ -98,10 +80,6 @@ export async function routeStakingTransaction(
     }
 
     default:
-      throw new ManifestMCPError(
-        ManifestMCPErrorCode.UNSUPPORTED_TX,
-        `Unsupported staking transaction subcommand: ${subcommand}`,
-        { availableSubcommands: ['delegate', 'unbond', 'redelegate'] }
-      );
+      throwUnsupportedSubcommand('tx', 'staking', subcommand);
   }
 }