npm - @caatinga/cli - Versions diffs - 0.2.3 → 2.0.0 - Mend

@caatinga/cli 0.2.3 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (49) hide show

package/templates/marketplace-with-token/contracts/token/Cargo.toml ADDED Viewed

@@ -0,0 +1,24 @@
+[package]
+name = "token"
+version = "0.1.0"
+rust-version = "1.84.0"
+edition = "2021"
+[lib]
+crate-type = ["cdylib"]
+[dependencies]
+soroban-sdk = "22.0.1"
+[dev-dependencies]
+soroban-sdk = { version = "22.0.1", 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/marketplace-with-token/contracts/token/src/lib.rs ADDED Viewed

@@ -0,0 +1,13 @@
+#![no_std]
+use soroban_sdk::{contract, contractimpl, Env};
+#[contract]
+pub struct TokenContract;
+#[contractimpl]
+impl TokenContract {
+    pub fn version(_env: Env) -> u32 {
+        1
+    }
+}

package/templates/marketplace-with-token/index.html ADDED Viewed

@@ -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/marketplace-with-token/package.json ADDED Viewed

@@ -0,0 +1,28 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "caatinga:build": "caatinga build token && caatinga build marketplace",
+    "caatinga:deploy": "caatinga deploy --network testnet",
+    "caatinga:generate": "caatinga generate token && caatinga generate marketplace"
+  },
+  "dependencies": {
+    "@caatinga/client": "^2.0.0",
+    "@caatinga/core": "^2.0.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "vite": "^6.0.6"
+  },
+  "devDependencies": {
+    "@caatinga/cli": "^2.0.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/marketplace-with-token/src/App.tsx ADDED Viewed

@@ -0,0 +1,57 @@
+const deploySteps = [
+  "Build token and marketplace contracts",
+  "Deploy token first so artifacts capture its contractId",
+  "Deploy marketplace and inject tokenContractId via __constructor",
+  "Generate bindings for both contracts"
+];
+export default function App() {
+  return (
+    <main className="app-shell">
+      <header className="hero">
+        <p className="eyebrow">Caatinga Multi-Contract</p>
+        <h1>__PROJECT_NAME__</h1>
+        <p className="lede">
+          Official demo template for dependency-ordered deploys where the marketplace constructor
+          receives the deployed token contract ID.
+        </p>
+      </header>
+      <section className="panel">
+        <div className="panel__header">
+          <div>
+            <p className="eyebrow">Contracts</p>
+            <h2>Deployment graph</h2>
+          </div>
+          <span className="network-pill">testnet</span>
+        </div>
+        <div className="graph">
+          <article className="graph-card">
+            <p className="graph-card__label">Root contract</p>
+            <h3>token</h3>
+            <p>Deploys first and publishes its contract ID into local artifacts.</p>
+          </article>
+          <article className="graph-card graph-card--dependent">
+            <p className="graph-card__label">Dependent contract</p>
+            <h3>marketplace</h3>
+            <p>
+              Receives <code>tokenContractId</code> through <code>deployArgs</code> mapped to the
+              contract <code>__constructor</code>.
+            </p>
+          </article>
+        </div>
+      </section>
+      <section className="panel">
+        <p className="eyebrow">Flow</p>
+        <h2>What this template proves</h2>
+        <ol className="steps">
+          {deploySteps.map((step) => (
+            <li key={step}>{step}</li>
+          ))}
+        </ol>
+      </section>
+    </main>
+  );
+}

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

@@ -0,0 +1,12 @@
+export const templateId = "marketplace-with-token";
+export function describeDeployFlow(): string {
+  return [
+    "1. caatinga build token",
+    "2. caatinga build marketplace",
+    "3. caatinga deploy --network testnet --source <identity>",
+    "4. caatinga generate token",
+    "5. caatinga generate marketplace",
+    "marketplace.deployArgs.tokenContractId resolves from caatinga.artifacts.json and is passed to __constructor"
+  ].join("\n");
+}

package/templates/marketplace-with-token/src/main.tsx ADDED Viewed

@@ -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/marketplace-with-token/src/styles.css ADDED Viewed

@@ -0,0 +1,157 @@
+:root {
+  color: #142322;
+  background:
+    radial-gradient(circle at top, rgba(255, 208, 118, 0.22), transparent 32%),
+    linear-gradient(180deg, #f7f1e4 0%, #efe7d2 100%);
+  font-family:
+    "Iowan Old Style", "Palatino Linotype", "Book Antiqua", Georgia, serif;
+  font-synthesis: none;
+  text-rendering: optimizeLegibility;
+}
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  min-width: 320px;
+  min-height: 100vh;
+}
+code {
+  padding: 0.1rem 0.35rem;
+  border-radius: 0.35rem;
+  background: rgba(20, 35, 34, 0.08);
+  font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
+}
+.app-shell {
+  width: min(960px, calc(100vw - 32px));
+  margin: 0 auto;
+  padding: 32px 0 48px;
+}
+.hero,
+.panel {
+  border: 1px solid rgba(20, 35, 34, 0.12);
+  border-radius: 24px;
+  background: rgba(255, 252, 245, 0.86);
+  box-shadow: 0 18px 60px rgba(20, 35, 34, 0.08);
+}
+.hero {
+  margin-bottom: 20px;
+  padding: clamp(24px, 5vw, 48px);
+}
+.panel {
+  margin-bottom: 20px;
+  padding: 24px;
+}
+.hero h1,
+.panel h2,
+.graph-card h3 {
+  margin: 0;
+}
+.hero h1 {
+  font-size: clamp(2.4rem, 8vw, 4.6rem);
+  line-height: 0.95;
+  max-width: 10ch;
+}
+.lede {
+  max-width: 60ch;
+  margin: 16px 0 0;
+  font-size: 1.05rem;
+  line-height: 1.6;
+}
+.eyebrow {
+  margin: 0 0 10px;
+  color: #7c5a16;
+  font-family: "Trebuchet MS", "Avenir Next", sans-serif;
+  font-size: 0.78rem;
+  font-weight: 800;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+}
+.panel__header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 20px;
+}
+.network-pill {
+  display: inline-flex;
+  align-items: center;
+  min-height: 32px;
+  border-radius: 999px;
+  padding: 0 12px;
+  background: #173f3a;
+  color: #fff8ec;
+  font-family: "Trebuchet MS", "Avenir Next", sans-serif;
+  font-size: 0.8rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+.graph {
+  display: grid;
+  gap: 16px;
+}
+.graph-card {
+  position: relative;
+  padding: 18px;
+  border-radius: 18px;
+  background: #fffdfa;
+  border: 1px solid rgba(20, 35, 34, 0.1);
+}
+.graph-card--dependent::before {
+  content: "dependsOn token";
+  display: inline-block;
+  margin-bottom: 12px;
+  padding: 0.3rem 0.6rem;
+  border-radius: 999px;
+  background: rgba(124, 90, 22, 0.12);
+  color: #7c5a16;
+  font-family: "Trebuchet MS", "Avenir Next", sans-serif;
+  font-size: 0.75rem;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+}
+.graph-card__label {
+  margin: 0 0 6px;
+  color: #5d6766;
+  font-family: "Trebuchet MS", "Avenir Next", sans-serif;
+  font-size: 0.8rem;
+  text-transform: uppercase;
+}
+.steps {
+  margin: 16px 0 0;
+  padding-left: 1.25rem;
+  line-height: 1.7;
+}
+@media (min-width: 700px) {
+  .graph {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+@media (max-width: 560px) {
+  .panel__header {
+    flex-direction: column;
+  }
+}

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

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

package/templates/marketplace-with-token/vite.config.ts ADDED Viewed

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

package/templates/react-vite-counter/.env.example ADDED Viewed

@@ -0,0 +1,5 @@
+VITE_WALLETCONNECT_PROJECT_ID=your_walletconnect_project_id
+VITE_APP_NAME=__PROJECT_NAME__
+VITE_APP_DESCRIPTION=Caatinga counter dApp
+VITE_APP_URL=https://your-dapp-url.com
+VITE_APP_ICON_URL=https://your-dapp-url.com/icon.png

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

@@ -0,0 +1,83 @@
+# __PROJECT_NAME__
+Caatinga counter dApp for Stellar/Soroban.
+## CLI Flow
+```bash
+npm install          # or: pnpm install
+npx caatinga build counter
+npx caatinga deploy counter --network testnet --source alice
+npx caatinga generate counter --network testnet
+npx caatinga invoke counter.increment --network testnet --source alice
+npm run dev          # or: pnpm dev
+```
+Run `build` before `deploy` (WASM required) and `deploy` before `generate` (contract ID required).
+Use a local Stellar CLI identity alias for `--source`; public `G...` addresses, seed phrases, and secret keys are rejected for signing operations.
+## Package managers
+Templates default to npm, but pnpm 10.26+/11.x is supported via the shipped `pnpm-workspace.yaml` (`allowBuilds.esbuild: true`, `blockExoticSubdeps: false`).
+Package scripts wrap the CLI:
+```bash
+npm run caatinga:build
+npm run caatinga:deploy -- --network testnet --source alice
+npm run caatinga:generate -- --network testnet
+```
+With pnpm, use `pnpm run caatinga:build` (and the same pattern for deploy/generate). `npx caatinga build counter` works without going through the package manager.
+## Client Smoke Path
+After `caatinga generate`, wire generated bindings to the client:
+```ts
+import { createCaatingaClient } from "@caatinga/client";
+import { createStellarWalletsKitAdapter } from "@caatinga/client/stellar-wallets-kit";
+import * as Counter from "./contracts/generated/counter";
+import artifacts from "../caatinga.artifacts.json";
+const wallet = createStellarWalletsKitAdapter();
+export const caatingaClient = createCaatingaClient({
+  network: {
+    name: "testnet",
+    rpcUrl: "https://soroban-testnet.stellar.org",
+    networkPassphrase: "Test SDF Network ; September 2015"
+  },
+  artifacts,
+  wallet,
+  contracts: {
+    counter: {
+      binding: Counter
+    }
+  }
+});
+```
+Build XDR without wallet signing:
+```ts
+const tx = await caatingaClient.contract("counter").buildXdr("increment");
+console.log(tx.preparedXdr);
+```
+Read the on-chain counter through simulation:
+```ts
+const count = await caatingaClient.contract("counter").read<number>("get");
+console.log(count);
+```
+Invoke through a connected wallet:
+```ts
+const result = await caatingaClient.contract("counter").invoke("increment", {
+  debugXdr: true
+});
+console.log(result.transactionHash);
+```

package/templates/react-vite-counter/caatinga.artifacts.json ADDED Viewed

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

package/templates/react-vite-counter/caatinga.config.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import { defineConfig } from "@caatinga/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/caatinga.template.json ADDED Viewed

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