movementkit-cli 1.0.7 → 1.0.10

package/dist/index.js

@@ -2912,7 +2912,7 @@ var cac = (name = "") => new CAC(name);
 // src/index.ts
 var import_picocolors9 = __toESM(require_picocolors(), 1);
 // package.json
-var version = "1.0.7";
+var version = "1.0.10";
 
 // node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);

package/kits/engineer/.claude/agents/frontend.md

@@ -37,6 +37,26 @@ You are a senior React frontend engineer specializing in Movement blockchain dAp
 **IMPORTANT**: Use strict TypeScript with no `any` types.
 **IMPORTANT**: Ensure token efficiency while maintaining high quality.
 
+## References
+- [TypeScript SDK](https://docs.movementnetwork.xyz/devs/interactonchain/tsSdk)
+- [Wallet Adapter](https://docs.movementnetwork.xyz/devs/interactonchain/wallet-adapter/connect_wallet)
+- [useWallet Hook](https://docs.movementnetwork.xyz/devs/interactonchain/wallet-adapter/useWallet/ConnectWallet)
+- [Sign & Submit](https://docs.movementnetwork.xyz/devs/interactonchain/wallet-adapter/useWallet/signAndSubmitTx)
+
+## Movement Network Configuration
+
+**Chain IDs:**
+- Mainnet: `126`
+- Testnet: `250`
+
+**RPC Endpoints:**
+- Mainnet: `https://mainnet.movementnetwork.xyz/v1`
+- Testnet: `https://testnet.movementnetwork.xyz/v1`
+- Faucet: `https://faucet.testnet.movementnetwork.xyz/`
+
+**Explorer:**
+- `https://explorer.movementnetwork.xyz/txn/{txHash}?network={mainnet|testnet}`
+
 ## Core Competencies
 
 1. **Wallet Integration**
@@ -81,72 +101,131 @@ You are a senior React frontend engineer specializing in Movement blockchain dAp
    - Integration tests for user flows
    - Mock wallet adapter for testing
 
-## Wallet Setup
+## Wallet Provider Setup
 
 ```tsx
+// src/provider/WalletProvider.tsx
 import { AptosWalletAdapterProvider } from "@aptos-labs/wallet-adapter-react";
-import { PetraWallet } from "petra-plugin-wallet-adapter";
+import { AptosConfig, Network } from "@aptos-labs/ts-sdk";
+import { PropsWithChildren } from "react";
+
+export const WalletProvider = ({ children }: PropsWithChildren) => {
+  const wallets = [
+    // Add plugins for non-AIP-62 compliant wallets here
+  ];
 
-const wallets = [new PetraWallet()];
+  const config = new AptosConfig({
+    network: Network.TESTNET,
+    fullnode: 'https://testnet.movementnetwork.xyz/v1',
+    faucet: 'https://faucet.testnet.movementnetwork.xyz/'
+  });
 
-function App() {
   return (
-    <AptosWalletAdapterProvider plugins={wallets} autoConnect={true}>
-      <MainContent />
+    <AptosWalletAdapterProvider
+      plugins={wallets}
+      autoConnect={true}
+      dappConfig={config}
+      onError={(error) => console.error("Wallet error:", error)}
+    >
+      {children}
     </AptosWalletAdapterProvider>
   );
-}
+};
 ```
 
-## Custom Hook Pattern
+**Provider Props:**
+| Field | Description |
+|-------|-------------|
+| `autoConnect` | Auto-connect on page reload (recommended: `true`) |
+| `dappConfig` | Network config (fullnode, faucet URLs) |
+| `plugins` | Legacy wallet plugins array |
+| `onError` | Error callback |
+| `optInWallets` | Limit supported AIP-62 wallets (e.g., `['Petra']`) |
+
+## Aptos Client Setup
 
 ```tsx
-import { useWallet } from "@aptos-labs/wallet-adapter-react";
-import { Aptos, AptosConfig } from "@aptos-labs/ts-sdk";
+import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
+
+// Movement Network client
+const config = new AptosConfig({
+  network: Network.CUSTOM,
+  fullnode: 'https://testnet.movementnetwork.xyz/v1',
+  faucet: 'https://faucet.testnet.movementnetwork.xyz/'
+});
+const aptos = new Aptos(config);
+```
 
-const client = new Aptos(new AptosConfig({
-  fullnode: "https://full.testnet.movementinfra.xyz/v1"
-}));
+## Reading Data (View Functions)
 
-export function useBalance(address?: string) {
-  const [balance, setBalance] = useState<bigint | null>(null);
+```tsx
+import { useState, useEffect } from "react";
+import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
+
+const MODULE_ADDRESS = "YOUR_CONTRACT_ADDRESS";
+const config = new AptosConfig({
+  network: Network.CUSTOM,
+  fullnode: 'https://testnet.movementnetwork.xyz/v1',
+});
+const aptos = new Aptos(config);
+
+export function useContractValue(address?: string) {
+  const [value, setValue] = useState<string | null>(null);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<Error | null>(null);
 
   useEffect(() => {
     if (!address) return;
     setLoading(true);
-    client.view<[string]>({
-      payload: {
-        function: `${MODULE}::token::balance`,
-        functionArguments: [address],
-      },
-    })
-      .then(([bal]) => setBalance(BigInt(bal)))
+
+    const viewPayload = {
+      function: `${MODULE_ADDRESS}::module_name::get_value`,
+      functionArguments: [address]
+    };
+
+    aptos.view({ payload: viewPayload })
+      .then((result) => setValue(result[0] as string))
       .catch(setError)
       .finally(() => setLoading(false));
   }, [address]);
 
-  return { balance, loading, error };
+  return { value, loading, error };
 }
 ```
 
-## Transaction Flow
+## Sign & Submit Transactions
 
 ```tsx
-export function useTransfer() {
-  const { signAndSubmitTransaction } = useWallet();
+import { useWallet } from "@aptos-labs/wallet-adapter-react";
+import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
+import { useState } from "react";
+
+const MODULE_ADDRESS = "YOUR_CONTRACT_ADDRESS";
+const config = new AptosConfig({
+  network: Network.CUSTOM,
+  fullnode: 'https://testnet.movementnetwork.xyz/v1',
+});
+const aptos = new Aptos(config);
+
+export function useContractAction() {
+  const { account, signAndSubmitTransaction } = useWallet();
   const [status, setStatus] = useState<"idle" | "pending" | "success" | "error">("idle");
 
-  const transfer = async (recipient: string, amount: bigint) => {
+  const execute = async (arg1: string, arg2: number) => {
+    if (!account) throw new Error("Wallet not connected");
+
     setStatus("pending");
     try {
       const response = await signAndSubmitTransaction({
+        sender: account.address,
         data: {
-          function: `${MODULE}::token::transfer`,
-          functionArguments: [recipient, amount.toString()],
+          function: `${MODULE_ADDRESS}::module_name::entry_function`,
+          functionArguments: [arg1, arg2],
         },
       });
+
+      // Wait for transaction confirmation
+      await aptos.waitForTransaction({ transactionHash: response.hash });
       setStatus("success");
       return response.hash;
     } catch (e) {
@@ -155,28 +234,61 @@ export function useTransfer() {
     }
   };
 
-  return { transfer, status };
+  return { execute, status };
 }
 ```
 
+## useWallet Hook API
+
+```tsx
+import { useWallet } from "@aptos-labs/wallet-adapter-react";
+
+const {
+  connected,           // boolean - wallet connection status
+  isLoading,           // boolean - loading state
+  account,             // AccountInfo | null - current account
+  network,             // NetworkInfo | null - current network
+  wallet,              // WalletInfo | null - current wallet
+  wallets,             // Available wallets list
+  connect,             // (walletName) => void
+  disconnect,          // () => void
+  signAndSubmitTransaction, // (tx) => Promise<{hash}>
+  signTransaction,     // (tx, asFeePayer?, options?) => Promise<AccountAuthenticator>
+  submitTransaction,   // (tx) => Promise<PendingTransactionResponse>
+  signMessage,         // (message) => Promise<SignMessageResponse>
+  signMessageAndVerify,// (message) => Promise<boolean>
+  changeNetwork,       // (network) => Promise<AptosChangeNetworkOutput>
+} = useWallet();
+```
+
 ## Project Structure
 
 ```
 frontend/
 ├── src/
 │   ├── App.tsx              # Entry with wallet provider
+│   ├── provider/
+│   │   └── WalletProvider.tsx # Wallet provider config
 │   ├── components/          # React components
 │   │   ├── WalletButton.tsx
 │   │   ├── BalanceDisplay.tsx
 │   │   └── ...
 │   ├── hooks/               # Custom hooks
-│   │   ├── useBalance.ts
-│   │   └── useTransfer.ts
-│   ├── contexts/            # React contexts
-│   └── lib/                 # Utilities
+│   │   ├── useContractValue.ts
+│   │   └── useContractAction.ts
+│   ├── lib/                 # Utilities
+│   │   └── aptos.ts         # Aptos client config
+│   └── config/
+│       └── constants.ts     # Contract addresses, network
 └── tests/
 ```
 
+## Required Dependencies
+
+```bash
+npm install @aptos-labs/wallet-adapter-react @aptos-labs/ts-sdk
+```
+
 ## Tools & Commands
 
 ```bash

package/kits/engineer/.claude/commands/cook/contracts.md

@@ -1,7 +1,11 @@
 # /cook:contracts - Move Smart Contract Generation
 
+**Agent:** `smart-contract`
+
 Generate Move smart contracts for the Movement blockchain.
 
+**IMPORTANT**: Delegate to `smart-contract` agent.
+
 ## Prerequisites
 
 ### Install Movement CLI

package/kits/engineer/.claude/commands/cook/frontend.md

@@ -1,7 +1,11 @@
 # /cook:frontend - React Frontend Generation
 
+**Agent:** `frontend`
+
 Generate React frontend with wallet integration for Movement blockchain.
 
+**IMPORTANT**: Delegate to `frontend` agent.
+
 ## References
 - [TypeScript SDK](https://docs.movementnetwork.xyz/devs/interactonchain/tsSdk)
 - [Wallet Adapter](https://docs.movementnetwork.xyz/devs/interactonchain/wallet-adapter/connect_wallet)

package/kits/engineer/.claude/commands/cook.md

@@ -1,7 +1,11 @@
 # /cook - Full dApp Code Generation
 
+**Agents:** `smart-contract`, `frontend`
+
 Generate complete production-ready code for a Movement blockchain dApp.
 
+**IMPORTANT**: Delegate to `smart-contract` agent for contracts, then `frontend` agent for frontend.
+
 ## Prerequisites
 
 ### Install Movement CLI

package/kits/engineer/.claude/commands/deploy-full.md

@@ -1,7 +1,11 @@
 # /deploy-full - Full Deployment to Movement Network
 
+**Agent:** `devops`
+
 Deploy the complete dApp to Movement testnet or mainnet.
 
+**IMPORTANT**: Delegate to `devops` agent.
+
 ## Prerequisites
 
 1. **Movement CLI installed** - See [Movement CLI docs](https://docs.movementnetwork.xyz/devs/movementcli)

package/kits/engineer/.claude/commands/deploy-smart-contract.md

@@ -1,7 +1,11 @@
 # /deploy-smart-contract - Deploy Move Smart Contracts
 
+**Agent:** `devops`
+
 Deploy Move smart contracts to the Movement Network (testnet or mainnet).
 
+**IMPORTANT**: Delegate to `devops` agent.
+
 ## Prerequisites
 
 1. **Movement CLI installed** - See [Movement CLI docs](https://docs.movementnetwork.xyz/devs/movementcli)

package/kits/engineer/.claude/commands/docs/generate.md

@@ -1,7 +1,11 @@
 # /docs:generate - Auto-Generate Documentation
 
+**Agents:** `smart-contract`, `frontend`
+
 Automatically generate documentation from code for the Movement dApp.
 
+**IMPORTANT**: Delegate to `smart-contract` agent for contract docs, `frontend` agent for frontend docs.
+
 ## Workflow
 
 ### Step 1: Analyze Codebase

package/kits/engineer/.claude/commands/docs/init.md

@@ -1,7 +1,11 @@
 # /docs:init - Initialize Documentation Structure
 
+**Agent:** `product-manager`
+
 Initialize the documentation structure for the Movement dApp project.
 
+**IMPORTANT**: Delegate to `product-manager` agent.
+
 ## Workflow
 
 ### Step 1: Create Documentation Directories

package/kits/engineer/.claude/commands/plan.md

@@ -1,7 +1,10 @@
 # /plan - Product Requirements for Movement dApps
 
+**Agent:** `product-manager`
+
 Create Product Requirements Document (PRD), User Stories, and Acceptance Criteria for a Movement blockchain dApp.
 
+**IMPORTANT**: Delegate to `product-manager` agent.
 **IMPORTANT**: This command focuses on WHAT to build, not HOW. No technical implementation details.
 
 ## Workflow

package/kits/engineer/.claude/commands/review.md

@@ -1,7 +1,11 @@
 # /review - Code Quality and Security Auditing
 
+**Agents:** `smart-contract`, `frontend`
+
 Perform comprehensive code review and security audit for the Movement dApp.
 
+**IMPORTANT**: Delegate to `smart-contract` agent for contract review, `frontend` agent for frontend review.
+
 ## Workflow
 
 ### Step 1: Move Contract Security Audit

package/kits/engineer/.claude/commands/test.md

@@ -1,7 +1,11 @@
 # /test - Comprehensive Test Generation and Execution
 
+**Agent:** `tester`
+
 Generate and run comprehensive tests for the Movement dApp.
 
+**IMPORTANT**: Delegate to `tester` agent.
+
 ## Workflow
 
 ### Step 1: Analyze Codebase

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "movementkit-cli",
-  "version": "1.0.7",
+  "version": "1.0.10",
   "description": "CLI tool for bootstrapping and updating Movement Kit projects for Movement blockchain development",
   "type": "module",
   "repository": {