@kaleido-xlm/cli 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaleido-xlm/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Developer toolkit CLI for building dApps on Stellar/Soroban",
   "keywords": [
     "stellar",
@@ -38,11 +38,12 @@
   },
   "files": [
     "dist",
+    "templates",
     "README.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@kaleido-xlm/core": "^0.1.0",
+    "@kaleido-xlm/core": "^0.1.1",
     "chalk": "^5.4.1",
     "commander": "^12.1.0"
   },
@@ -53,7 +54,7 @@
     "vitest": "^2.1.8"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts --format esm --dts --clean && rm -rf ./templates && cp -r ../templates ./templates",
     "dev": "tsx src/index.ts",
     "test": "vitest run --pool=threads",
     "typecheck": "tsc --noEmit"

package/templates/marketplace-with-token/README.md

@@ -0,0 +1,19 @@
+# __PROJECT_NAME__
+
+Experimental Kaleido multi-contract template.
+
+## Deploy
+
+```bash
+npm install
+npx kaleido build token
+npx kaleido build marketplace
+npx kaleido deploy --network testnet --source alice
+```
+
+Deploy order:
+
+1. `token`
+2. `marketplace`
+
+`marketplace.deployArgs.tokenContractId` resolves from `${contracts.token.contractId}` after the token deploy writes `kaleido.artifacts.json`.

package/templates/marketplace-with-token/kaleido.artifacts.json

@@ -0,0 +1,10 @@
+{
+  "project": "__PROJECT_NAME__",
+  "version": 1,
+  "networks": {
+    "testnet": {
+      "contracts": {},
+      "dependencyGraph": {}
+    }
+  }
+}

package/templates/marketplace-with-token/kaleido.config.ts

@@ -0,0 +1,30 @@
+import { defineConfig } from "@kaleido-xlm/core";
+
+export default defineConfig({
+  project: "__PROJECT_NAME__",
+  defaultNetwork: "testnet",
+  contracts: {
+    token: {
+      path: "./contracts/token",
+      wasm: "./contracts/token/target/wasm32v1-none/release/token.wasm"
+    },
+    marketplace: {
+      path: "./contracts/marketplace",
+      wasm: "./contracts/marketplace/target/wasm32v1-none/release/marketplace.wasm",
+      dependsOn: ["token"],
+      deployArgs: {
+        tokenContractId: "${contracts.token.contractId}"
+      }
+    }
+  },
+  networks: {
+    testnet: {
+      rpcUrl: "https://soroban-testnet.stellar.org",
+      networkPassphrase: "Test SDF Network ; September 2015"
+    }
+  },
+  frontend: {
+    framework: "vite-react",
+    bindingsOutput: "./src/contracts/generated"
+  }
+});

package/templates/marketplace-with-token/kaleido.template.json

@@ -0,0 +1,21 @@
+{
+  "name": "marketplace-with-token",
+  "version": "0.1.0",
+  "description": "Experimental multi-contract Soroban template with token dependency injection.",
+  "kaleido": {
+    "compatibleCore": "^0.1.0",
+    "templateVersion": 1
+  },
+  "frontend": {
+    "framework": "vite-react",
+    "packageManager": "npm"
+  },
+  "contracts": {
+    "path": "contracts",
+    "default": "marketplace"
+  },
+  "files": {
+    "config": "kaleido.config.ts",
+    "artifacts": "kaleido.artifacts.json"
+  }
+}

package/templates/marketplace-with-token/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "kaleido:build": "kaleido build token && kaleido build marketplace",
+    "kaleido:deploy": "kaleido deploy --network testnet"
+  },
+  "dependencies": {
+    "@kaleido-xlm/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@kaleido-xlm/cli": "^0.1.0",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/marketplace-with-token/src/main.ts

@@ -0,0 +1 @@
+export const placeholder = "marketplace-with-token template bootstrap";

package/templates/marketplace-with-token/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src", "kaleido.config.ts"]
+}

package/templates/react-vite-counter/README.md

@@ -0,0 +1,58 @@
+# __PROJECT_NAME__
+
+Kaleido counter dApp for Stellar/Soroban.
+
+## CLI Flow
+
+```bash
+npm install
+npx kaleido build counter
+npx kaleido deploy counter --network testnet --source alice
+npx kaleido generate counter --network testnet
+npx kaleido invoke counter.increment --network testnet --source alice
+npm run dev
+```
+
+Use a Stellar CLI identity alias or public account address for `--source`; do not pass seed phrases or secret keys.
+
+## Client Smoke Path
+
+After `kaleido generate`, wire generated bindings to the client:
+
+```ts
+import { createKaleidoClient } from "@kaleido-xlm/client";
+import { freighterWalletAdapter } from "@kaleido-xlm/client/freighter";
+import * as Counter from "./contracts/generated/counter";
+import artifacts from "../kaleido.artifacts.json";
+
+export const kaleidoClient = createKaleidoClient({
+  network: {
+    name: "testnet",
+    rpcUrl: "https://soroban-testnet.stellar.org",
+    networkPassphrase: "Test SDF Network ; September 2015"
+  },
+  artifacts,
+  wallet: freighterWalletAdapter,
+  contracts: {
+    counter: {
+      binding: Counter
+    }
+  }
+});
+```
+
+Build XDR without wallet signing:
+
+```ts
+const tx = await kaleidoClient.contract("counter").buildXdr("increment");
+console.log(tx.preparedXdr);
+```
+
+Invoke through Freighter:
+
+```ts
+const result = await kaleidoClient.contract("counter").invoke("increment", {
+  debugXdr: true
+});
+console.log(result.transactionHash);
+```

package/templates/react-vite-counter/contracts/counter/Cargo.toml

@@ -0,0 +1,23 @@
+[package]
+name = "counter"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+soroban-sdk = "26.0.0"
+
+[dev-dependencies]
+soroban-sdk = { version = "26.0.0", features = ["testutils"] }
+
+[profile.release]
+opt-level = "z"
+overflow-checks = true
+debug = 0
+strip = "symbols"
+debug-assertions = false
+panic = "abort"
+codegen-units = 1
+lto = true

package/templates/react-vite-counter/contracts/counter/src/lib.rs

@@ -0,0 +1,36 @@
+#![no_std]
+
+use soroban_sdk::{contract, contractimpl, Env};
+
+#[contract]
+pub struct CounterContract;
+
+#[contractimpl]
+impl CounterContract {
+    pub fn get(env: Env) -> u32 {
+        env.storage().instance().get(&"count").unwrap_or(0)
+    }
+
+    pub fn increment(env: Env) -> u32 {
+        let count = Self::get(env.clone()) + 1;
+        env.storage().instance().set(&"count", &count);
+        count
+    }
+}
+
+#[cfg(test)]
+mod test {
+    use super::*;
+    use soroban_sdk::Env;
+
+    #[test]
+    fn increments_counter() {
+        let env = Env::default();
+        let contract_id = env.register(CounterContract, ());
+        let client = CounterContractClient::new(&env, &contract_id);
+
+        assert_eq!(client.get(), 0);
+        assert_eq!(client.increment(), 1);
+        assert_eq!(client.get(), 1);
+    }
+}

package/templates/react-vite-counter/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__PROJECT_NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react-vite-counter/kaleido.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig } from "@kaleido-xlm/core";
+
+export default defineConfig({
+  project: "__PROJECT_NAME__",
+  defaultNetwork: "testnet",
+  contracts: {
+    counter: {
+      path: "./contracts/counter",
+      wasm: "./contracts/counter/target/wasm32v1-none/release/counter.wasm"
+    }
+  },
+  networks: {
+    testnet: {
+      rpcUrl: "https://soroban-testnet.stellar.org",
+      networkPassphrase: "Test SDF Network ; September 2015"
+    },
+    mainnet: {
+      rpcUrl: "https://mainnet.sorobanrpc.com",
+      networkPassphrase: "Public Global Stellar Network ; September 2015"
+    }
+  },
+  frontend: {
+    framework: "vite-react",
+    bindingsOutput: "./src/contracts/generated"
+  }
+});

package/templates/react-vite-counter/kaleido.template.json

@@ -0,0 +1,21 @@
+{
+  "name": "react-vite-counter",
+  "version": "0.1.0",
+  "description": "Minimal Vite + React + Soroban counter dApp.",
+  "kaleido": {
+    "compatibleCore": "^0.1.0",
+    "templateVersion": 1
+  },
+  "frontend": {
+    "framework": "vite-react",
+    "packageManager": "npm"
+  },
+  "contracts": {
+    "path": "contracts",
+    "default": "counter"
+  },
+  "files": {
+    "config": "kaleido.config.ts",
+    "artifacts": "kaleido.artifacts.json"
+  }
+}

package/templates/react-vite-counter/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "kaleido:build": "kaleido build counter",
+    "kaleido:deploy": "kaleido deploy counter",
+    "kaleido:generate": "kaleido generate counter"
+  },
+  "dependencies": {
+    "@kaleido-xlm/client": "^0.1.0",
+    "@kaleido-xlm/core": "^0.1.0",
+    "@stellar/freighter-api": "^4.0.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "vite": "^6.0.6",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@kaleido-xlm/cli": "^0.1.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/react-vite-counter/public/.gitkeep

@@ -0,0 +1 @@
+

package/templates/react-vite-counter/src/App.tsx

@@ -0,0 +1,18 @@
+import { CounterCard } from "./components/CounterCard";
+import { WalletButton } from "./components/WalletButton";
+
+export default function App() {
+  return (
+    <main className="app-shell">
+      <header className="topbar">
+        <div>
+          <p className="eyebrow">Kaleido</p>
+          <h1>__PROJECT_NAME__</h1>
+        </div>
+        <WalletButton />
+      </header>
+
+      <CounterCard />
+    </main>
+  );
+}

package/templates/react-vite-counter/src/components/CounterCard.tsx

@@ -0,0 +1,29 @@
+import { useMemo, useState } from "react";
+
+export function CounterCard() {
+  const [count, setCount] = useState(0);
+  const formattedCount = useMemo(() => new Intl.NumberFormat().format(count), [count]);
+
+  return (
+    <section className="counter-panel" aria-labelledby="counter-title">
+      <div className="counter-panel__header">
+        <div>
+          <p className="eyebrow">Counter Contract</p>
+          <h2 id="counter-title">Counter</h2>
+        </div>
+        <span className="network-pill">testnet</span>
+      </div>
+
+      <div className="counter-value">{formattedCount}</div>
+
+      <div className="counter-actions">
+        <button type="button" onClick={() => setCount((value) => value + 1)}>
+          Increment
+        </button>
+        <button className="secondary-button" type="button" onClick={() => setCount(0)}>
+          Reset
+        </button>
+      </div>
+    </section>
+  );
+}

package/templates/react-vite-counter/src/components/WalletButton.tsx

@@ -0,0 +1,12 @@
+import { useState } from "react";
+
+export function WalletButton() {
+  const [connected, setConnected] = useState(false);
+
+  return (
+    <button className="wallet-button" type="button" onClick={() => setConnected((value) => !value)}>
+      <span className={connected ? "status-dot status-dot--on" : "status-dot"} />
+      {connected ? "Connected" : "Connect"}
+    </button>
+  );
+}

package/templates/react-vite-counter/src/contracts/generated/.gitkeep

@@ -0,0 +1 @@
+

package/templates/react-vite-counter/src/main.tsx

@@ -0,0 +1,10 @@
+import React from "react";
+import ReactDOM from "react-dom/client";
+import App from "./App";
+import "./styles.css";
+
+ReactDOM.createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

package/templates/react-vite-counter/src/styles.css

@@ -0,0 +1,155 @@
+:root {
+  color: #20232a;
+  background: #f4f2ec;
+  font-family:
+    Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-synthesis: none;
+  text-rendering: optimizeLegibility;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  min-width: 320px;
+  min-height: 100vh;
+  margin: 0;
+}
+
+button {
+  min-height: 44px;
+  border: 0;
+  border-radius: 8px;
+  padding: 0 16px;
+  background: #1d6154;
+  color: #ffffff;
+  font: inherit;
+  font-weight: 700;
+  cursor: pointer;
+}
+
+button:hover {
+  background: #174d44;
+}
+
+.app-shell {
+  width: min(960px, calc(100vw - 32px));
+  margin: 0 auto;
+  padding: 24px 0;
+}
+
+.topbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 32px;
+}
+
+.topbar h1,
+.counter-panel h2 {
+  margin: 0;
+  color: #16181d;
+  letter-spacing: 0;
+}
+
+.topbar h1 {
+  font-size: clamp(2rem, 8vw, 4rem);
+  line-height: 1;
+}
+
+.counter-panel h2 {
+  font-size: 1.35rem;
+}
+
+.eyebrow {
+  margin: 0 0 8px;
+  color: #697076;
+  font-size: 0.78rem;
+  font-weight: 800;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.wallet-button,
+.network-pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  white-space: nowrap;
+}
+
+.status-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 999px;
+  background: #a9afb4;
+}
+
+.status-dot--on {
+  background: #66c887;
+}
+
+.counter-panel {
+  border: 1px solid #d9d5ca;
+  border-radius: 8px;
+  padding: clamp(20px, 5vw, 40px);
+  background: #fffdf7;
+  box-shadow: 0 18px 60px rgba(32, 35, 42, 0.08);
+}
+
+.counter-panel__header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+}
+
+.network-pill {
+  min-height: 32px;
+  border: 1px solid #d9d5ca;
+  border-radius: 999px;
+  padding: 0 12px;
+  color: #45515a;
+  font-weight: 700;
+}
+
+.counter-value {
+  margin: 48px 0;
+  color: #111318;
+  font-size: clamp(5rem, 24vw, 12rem);
+  font-weight: 900;
+  line-height: 0.9;
+  letter-spacing: 0;
+}
+
+.counter-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+.secondary-button {
+  border: 1px solid #d9d5ca;
+  background: #ffffff;
+  color: #20232a;
+}
+
+.secondary-button:hover {
+  background: #f4f2ec;
+}
+
+@media (max-width: 560px) {
+  .topbar,
+  .counter-panel__header {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .wallet-button,
+  .counter-actions button {
+    width: 100%;
+    justify-content: center;
+  }
+}

package/templates/react-vite-counter/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["DOM", "DOM.Iterable", "ES2020"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src"],
+  "references": []
+}

package/templates/react-vite-counter/vite.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()]
+});