create-dubhe 1.2.0-pre.98 → 2.0.0

package/templates/nextjs/sui-farm/packages/contracts/scripts/query-dapp-revenue.ts

@@ -0,0 +1,95 @@
+/**
+ * Query dapp_revenue balance stored in DappStorage as a dynamic field.
+ *
+ * Run:
+ *   cd templates/nextjs/sui-farm/packages/contracts
+ *   npx tsx scripts/query-dapp-revenue.ts
+ */
+
+import { SuiClient } from '@0xobelisk/sui-client';
+import { Network, DappStorageId, FrameworkPackageId } from './config.ts';
+
+const RPC: Record<string, string> = {
+  localnet: 'http://127.0.0.1:9000',
+  devnet: 'https://fullnode.devnet.sui.io',
+  testnet: 'https://fullnode.testnet.sui.io',
+  mainnet: 'https://fullnode.mainnet.sui.io'
+};
+
+const COIN_SUI = '0x2::sui::SUI';
+
+async function queryDappRevenue() {
+  const client = new SuiClient({ url: RPC[Network] ?? RPC.localnet });
+
+  console.log(`Network  : ${Network}`);
+  console.log(`Storage  : ${DappStorageId}`);
+  console.log(`Framework: ${FrameworkPackageId}`);
+  console.log('');
+
+  if (!FrameworkPackageId) {
+    console.error('FrameworkPackageId is undefined in deployment.ts');
+    process.exit(1);
+  }
+
+  // ── 1. Query dapp_revenue via getDynamicFieldObject ────────────────────────
+  const revenueKeyType = `${FrameworkPackageId}::dapp_service::DappRevenueKey<${COIN_SUI}>`;
+
+  let revenueBalance = 0n;
+  try {
+    const result = await client.getDynamicFieldObject({
+      parentId: DappStorageId,
+      name: {
+        // Sui serializes empty structs with a synthetic dummy_field: bool
+        type: revenueKeyType,
+        value: { dummy_field: false }
+      }
+    });
+
+    if (result.error) {
+      // Field not yet created → balance is 0
+      console.log('dapp_revenue field not found (no fees collected yet)');
+    } else {
+      const fields = (result.data?.content as any)?.fields;
+      // Balance<SUI> is a struct with field `value: u64`
+      revenueBalance = BigInt(fields?.value ?? fields?.balance ?? 0);
+    }
+  } catch (e: any) {
+    // 404 / field not found → balance is 0
+    if (!e?.message?.includes('not found') && !e?.message?.includes('dynamic field')) {
+      throw e;
+    }
+    console.log('dapp_revenue dynamic field does not exist yet (0 revenue)');
+  }
+
+  const mist = revenueBalance;
+  const sui = Number(mist) / 1e9;
+
+  console.log(`─── DApp Revenue Balance ──────────────`);
+  console.log(`  ${mist} MIST`);
+  console.log(`  ${sui.toFixed(9)} SUI`);
+  console.log('');
+
+  // ── 2. Also read DappStorage basic info ───────────────────────────────────
+  const storageObj = await client.getObject({
+    id: DappStorageId,
+    options: { showContent: true }
+  });
+  const sf = (storageObj.data?.content as any)?.fields ?? {};
+
+  const creditPool = BigInt(sf.credit_pool ?? 0);
+  const freeCredit = BigInt(sf.free_credit ?? 0);
+  const totalSettled = BigInt(sf.total_settled ?? 0);
+  const settlementMode = Number(sf.settlement_mode ?? 0);
+
+  console.log(`─── DApp Storage Summary ───────────────`);
+  console.log(
+    `  settlement_mode  : ${settlementMode === 0 ? '0 (DAPP_SUBSIDIZES)' : '1 (USER_PAYS)'}`
+  );
+  console.log(`  credit_pool      : ${Number(creditPool) / 1e9} SUI  (${creditPool} MIST)`);
+  console.log(`  free_credit      : ${Number(freeCredit) / 1e9} SUI  (${freeCredit} MIST)`);
+  console.log(`  total_settled    : ${Number(totalSettled) / 1e9} SUI  (${totalSettled} MIST)`);
+  console.log(`  paused           : ${sf.paused}`);
+  console.log(`  version          : ${sf.version}`);
+}
+
+queryDappRevenue().catch(console.error);

package/templates/nextjs/sui-farm/packages/contracts/scripts/read-permit.ts

@@ -0,0 +1,72 @@
+/**
+ * read-permit.ts — Read the WorldPermit object ID from the deployed DappStorage.
+ *
+ * Usage:
+ *   cd templates/nextjs/sui-farm/packages/contracts
+ *   npx tsx scripts/read-permit.ts
+ *
+ * Outputs the WorldPermitId to add to deployment.ts.
+ */
+import { SuiClient, getFullnodeUrl } from '@0xobelisk/sui-client';
+import { Network, DappStorageId, PackageId } from './config.ts';
+
+async function main() {
+  const network = (process.argv[2] ?? Network) as any;
+
+  if (!DappStorageId || DappStorageId === '0x0') {
+    console.error('DappStorageId not set in deployment.ts. Deploy first.');
+    process.exit(1);
+  }
+
+  const client = new SuiClient({ url: getFullnodeUrl(network) });
+
+  let cursor: string | null | undefined = null;
+  let worldPermitId: string | null = null;
+
+  outer: while (true) {
+    const result = await client.getDynamicFields({
+      parentId: DappStorageId,
+      ...(cursor ? { cursor } : {})
+    });
+
+    for (const field of result.data) {
+      const nameStr = JSON.stringify(field.name as any);
+      if (nameStr.includes('world_permit_id')) {
+        const fieldObj = await client.getDynamicFieldObject({
+          parentId: DappStorageId,
+          name: field.name
+        });
+        const fields = (fieldObj.data?.content as any)?.fields ?? {};
+        const valueFields = fields.value?.fields ?? fields;
+        const objectId = valueFields.object_id ?? valueFields.value ?? null;
+        if (objectId) {
+          worldPermitId = typeof objectId === 'string' ? objectId : JSON.stringify(objectId);
+          break outer;
+        }
+      }
+    }
+
+    if (!result.hasNextPage) break;
+    cursor = result.nextCursor;
+  }
+
+  if (!worldPermitId) {
+    console.log('Could not find world_permit_id in DappStorage dynamic fields.');
+    console.log('Trying to find ScenePermit objects...');
+    const objs = await client.queryEvents({
+      query: { MoveEventType: `${PackageId.split('::')[0]}::dapp_system::ScenePermitCreated` }
+    });
+    console.log('Events:', JSON.stringify(objs.data, null, 2));
+    process.exit(1);
+  }
+
+  console.log('\n=== WorldPermitId found ===');
+  console.log(worldPermitId);
+  console.log('\nAdd to deployment.ts:');
+  console.log(`export const WorldPermitId = '${worldPermitId}';`);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/templates/nextjs/sui-farm/packages/contracts/scripts/seed.ts

@@ -0,0 +1,85 @@
+/**
+ * seed.ts — Populate initial on-chain state after deployment.
+ *
+ * Usage:
+ *   cd templates/nextjs/sui-farm/packages/contracts
+ *   pnpm tsx scripts/seed.ts localnet
+ *   pnpm tsx scripts/seed.ts testnet
+ *
+ * The deploy_hook.move already initialises shop_config, season_config, and the
+ * world permit during the publish transaction.  This script is for one-off
+ * admin actions:
+ *   1. Kick off the first season.
+ *   2. Override shop prices for testing purposes.
+ */
+
+import * as dotenv from 'dotenv';
+import { Dubhe, Transaction, getFullnodeUrl, NetworkType } from '@0xobelisk/sui-client';
+import { loadMetadata } from '@0xobelisk/sui-common';
+import { Network, PackageId, DappHubId, DappStorageId, FrameworkPackageId } from './config.ts';
+
+dotenv.config();
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+  const networkArg = (process.argv[2] ?? Network) as NetworkType;
+  const privateKey = process.env.PRIVATE_KEY;
+  if (!privateKey) {
+    throw new Error('PRIVATE_KEY env var not set. Run: pnpm account:gen and set in .env');
+  }
+
+  if (!PackageId || PackageId === '0x0') {
+    throw new Error('PackageId is 0x0 — deploy the contract first with: pnpm deploy ' + networkArg);
+  }
+
+  const metadata = await loadMetadata(networkArg, PackageId);
+  const dubhe = new Dubhe({
+    networkType: networkArg,
+    packageId: PackageId,
+    metadata,
+    secretKey: privateKey,
+    suiRpcUrl: getFullnodeUrl(networkArg),
+    dappHubId: DappHubId,
+    dappStorageId: DappStorageId,
+    frameworkPackageId: FrameworkPackageId
+  });
+
+  const adminAddress = dubhe.getAddress();
+  console.log(`Admin address: ${adminAddress}`);
+  console.log(`Network:       ${networkArg}`);
+  console.log(`Package ID:    ${PackageId}`);
+  console.log('');
+
+  // ── 1. Start Season 1 ─────────────────────────────────────────────────────
+  const seasonDurationMs = 7 * 24 * 60 * 60 * 1000; // 7 days
+  const endMs = Date.now() + seasonDurationMs;
+
+  console.log('Starting Season 1...');
+  const tx1 = new Transaction();
+  await dubhe.tx.season_system.start_season({
+    tx: tx1,
+    params: [
+      tx1.pure.u8(1), // season_id = 1
+      tx1.pure.u64(endMs), // end_ms
+      tx1.pure.u8(1) // bonus_crop = Wheat (type 1)
+    ]
+  });
+  const result1 = await dubhe.signAndSendTxn(tx1);
+  console.log(`Season 1 started! Digest: ${result1.digest}`);
+
+  // ── 2. Verify DApp storage fields ─────────────────────────────────────────
+  if (DappStorageId) {
+    console.log('\nDappStorage fields:');
+    const storageFields = await dubhe.getDappStorageFields(DappStorageId);
+    console.log(JSON.stringify(storageFields, null, 2));
+  }
+
+  console.log('\nSeed complete!');
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/templates/nextjs/sui-farm/packages/contracts/scripts/withdraw-dapp-revenue.ts

@@ -0,0 +1,56 @@
+/**
+ * Flush accumulated DApp revenue from DappStorage to the DApp admin wallet.
+ *
+ * Calls: dapp_system::withdraw_dapp_revenue<DappKey, SUI>(dh, dapp_storage, ctx)
+ * The Move function internally transfers the Coin to the stored dapp_admin address —
+ * anyone can trigger this (permissionless), only gas is needed.
+ *
+ * Run:
+ *   cd templates/nextjs/sui-farm/packages/contracts
+ *   PRIVATE_KEY="suiprivkey1q..." npx tsx scripts/withdraw-dapp-revenue.ts
+ */
+
+import { Dubhe, NetworkType, Transaction } from '@0xobelisk/sui-client';
+import { Network, DappHubId, DappStorageId, PackageId, FrameworkPackageId } from './config.ts';
+
+const COIN_SUI = '0x2::sui::SUI';
+const DAPP_KEY_TYPE = `${PackageId}::dapp_key::DappKey`;
+
+async function main() {
+  const secretKey = process.env.PRIVATE_KEY;
+  if (!secretKey) {
+    console.error('Error: set PRIVATE_KEY env var (any key with enough SUI for gas)');
+    console.error('  PRIVATE_KEY="suiprivkey1q..." npx tsx scripts/withdraw-dapp-revenue.ts');
+    process.exit(1);
+  }
+
+  const dubhe = new Dubhe({
+    networkType: Network as NetworkType,
+    packageId: PackageId,
+    metadata: undefined,
+    secretKey
+  });
+
+  console.log(`Caller address : ${dubhe.getAddress()}  (pays gas only)`);
+  console.log(`DappStorageId  : ${DappStorageId}`);
+  console.log('');
+
+  // withdraw_dapp_revenue is void — the Move contract transfers funds to dapp_admin directly.
+  const tx = new Transaction();
+  tx.moveCall({
+    target: `${FrameworkPackageId}::dapp_system::withdraw_dapp_revenue`,
+    typeArguments: [DAPP_KEY_TYPE, COIN_SUI],
+    arguments: [tx.object(DappHubId), tx.object(DappStorageId)]
+  });
+
+  console.log('Sending withdraw_dapp_revenue transaction...');
+  const result = await dubhe.signAndSendTxn({ tx });
+
+  if (result.effects?.status?.status === 'success') {
+    console.log(`✅ Success! Digest: ${result.digest}`);
+  } else {
+    console.error('❌ Transaction failed:', result.effects?.status);
+  }
+}
+
+main().catch(console.error);

package/templates/nextjs/sui-farm/packages/contracts/src/counter/Move.toml

@@ -0,0 +1,14 @@
+[package]
+name = "counter"
+version = "1.0.0"
+edition = "2024"
+
+[dependencies]
+Dubhe = { local = "../dubhe" }
+
+[addresses]
+counter = "0x0"
+
+[environments]
+testnet = "4c78adac"
+mainnet = "35834a8a"

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/codegen/dapp_key.move

@@ -0,0 +1,31 @@
+// Copyright (c) Obelisk Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/* Autogenerated file. Do not edit manually. */
+
+module counter::dapp_key {
+    use std::type_name;
+    use sui::address;
+    use std::ascii::String;
+
+    /// Authorization token for the app.
+
+    public struct DappKey has copy, drop {}
+
+    public(package) fun new(): DappKey {
+        DappKey {}
+    }
+
+    public fun to_string(): String {
+        type_name::with_defining_ids<DappKey>().into_string()
+    }
+
+    public fun package_id(): address {
+        let package_id_str = type_name::with_defining_ids<DappKey>().address_string();
+        address::from_ascii_bytes(package_id_str.as_bytes())
+    }
+
+    public fun eq<DappKey1: copy + drop, DappKey2: copy + drop>(_: &DappKey1, _: &DappKey2): bool {
+        type_name::with_defining_ids<DappKey1>() == type_name::with_defining_ids<DappKey2>()
+    }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/codegen/error.move

@@ -0,0 +1,10 @@
+// Copyright (c) Obelisk Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/* Autogenerated file. Do not edit manually. */
+
+module counter::error {
+    #[error]
+    const EInvalidIncrement: vector<u8> = b"Number can't be incremented, must be more than 0";
+    public fun invalid_increment(condition: bool) { assert!(condition, EInvalidIncrement) }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/codegen/genesis.move

@@ -0,0 +1,33 @@
+#[allow(lint(share_owned))]
+module counter::genesis {
+    use sui::clock::Clock;
+    use dubhe::dapp_service::{DappHub, DappStorage};
+    use counter::dapp_key;
+    use dubhe::dapp_system;
+    use std::ascii::string;
+
+    // The one-shot guard is enforced inside dapp_system::create_dapp, which
+    // records the DappKey type in DappHub before returning DappStorage.
+    // genesis.move does not need to carry its own guard.
+    public fun run(dapp_hub: &mut DappHub, clock: &Clock, ctx: &mut TxContext) {
+        // create_dapp aborts with dapp_already_initialized_error on repeated calls.
+        let dapp_key = dapp_key::new();
+        let mut ds = dapp_system::create_dapp(dapp_key, dapp_hub, string(b"counter"), string(b"counter contract"), 1, clock, ctx);
+
+        // Set up initial DApp state (e.g. default resource values).
+        counter::deploy_hook::run(&mut ds, ctx);
+
+        // Share DappStorage so every transaction can access it.
+        transfer::public_share_object(ds);
+    }
+
+    // Called during contract upgrades to register newly added resource tables
+    // and run any custom migration logic. `dubhe upgrade` rewrites the region
+    // between the separator comments; do not edit that block manually.
+    public(package) fun migrate(_dapp_hub: &mut DappHub, _dapp_storage: &mut DappStorage, _ctx: &mut TxContext) {
+        // ==========================================
+        // Add custom migration logic here (e.g. initialise new resource defaults).
+        // migrate_to_vN in migrate.move calls this function automatically.
+        // ==========================================
+    }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/codegen/init_test.move

@@ -0,0 +1,23 @@
+#[test_only]
+
+module counter::init_test {
+  use dubhe::dapp_system;
+
+  /// Create a DappHub for testing without sharing it.
+  /// Suitable for unit tests that need a DappHub context.
+  public fun create_dapp_hub_for_testing(ctx: &mut TxContext): dubhe::dapp_service::DappHub {
+    dapp_system::create_dapp_hub_for_testing(ctx)
+  }
+
+  /// Create a DappStorage for this DApp without sharing it.
+  /// Suitable for unit tests that exercise global-resource functions.
+  public fun create_dapp_storage_for_testing(ctx: &mut TxContext): dubhe::dapp_service::DappStorage {
+    dubhe::dapp_system::create_dapp_storage_for_testing<counter::dapp_key::DappKey>(ctx)
+  }
+
+  /// Create a UserStorage for `owner` without sharing it.
+  /// Suitable for unit tests that exercise user-level resource functions.
+  public fun create_user_storage_for_testing(owner: address, ctx: &mut TxContext): dubhe::dapp_service::UserStorage {
+    dubhe::dapp_system::create_user_storage_for_testing<counter::dapp_key::DappKey>(owner, ctx)
+  }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/codegen/resources/counter1.move

@@ -0,0 +1,64 @@
+// Copyright (c) Obelisk Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/* Autogenerated file. Do not edit manually. */
+
+module counter::counter1 {
+    use sui::bcs::{to_bytes};
+    use dubhe::dapp_service::UserStorage;
+    use dubhe::dapp_system;
+    use counter::dapp_key;
+    use counter::dapp_key::DappKey;
+
+
+    const TABLE_NAME: vector<u8> = b"counter1";
+    const OFFCHAIN: bool = false;
+
+
+    public fun has(user_storage: &UserStorage): bool {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        dapp_system::has_record<DappKey>(user_storage, key_tuple)
+    }
+
+    public fun ensure_has(user_storage: &UserStorage) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        dapp_system::ensure_has_record<DappKey>(user_storage, key_tuple)
+    }
+
+    public fun ensure_has_not(user_storage: &UserStorage) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        dapp_system::ensure_has_not_record<DappKey>(user_storage, key_tuple)
+    }
+
+    public(package) fun delete(user_storage: &mut UserStorage, ctx: &TxContext) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        dapp_system::delete_record<DappKey>(dapp_key::new(), user_storage, key_tuple, vector[b"value"], ctx);
+    }
+
+    public fun get(user_storage: &UserStorage): (u32) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        let value_raw = dapp_system::get_field<DappKey>(user_storage, key_tuple, b"value");
+        let mut value_bcs = sui::bcs::new(value_raw);
+        let value = sui::bcs::peel_u32(&mut value_bcs);
+        (value)
+    }
+
+    public(package) fun set(user_storage: &mut UserStorage, value: u32, ctx: &mut TxContext) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        let field_names = vector[b"value"];
+        let value_tuple = encode(value);
+        dapp_system::set_record<DappKey>(dapp_key::new(), user_storage, key_tuple, field_names, value_tuple, OFFCHAIN, ctx);
+    }
+
+    public fun encode(value: u32): vector<vector<u8>> {
+        let mut value_tuple = vector::empty();
+        value_tuple.push_back(to_bytes(&value));
+        value_tuple
+    }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/codegen/resources/counter2.move

@@ -0,0 +1,70 @@
+// Copyright (c) Obelisk Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/* Autogenerated file. Do not edit manually. */
+
+module counter::counter2 {
+    use sui::bcs::{to_bytes};
+    use dubhe::dapp_service::UserStorage;
+    use dubhe::dapp_system;
+    use counter::dapp_key;
+    use counter::dapp_key::DappKey;
+
+
+    const TABLE_NAME: vector<u8> = b"counter2";
+    const OFFCHAIN: bool = false;
+
+    public fun has(user_storage: &UserStorage, data: u64): bool {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        key_tuple.push_back(to_bytes(&data));
+        dapp_system::has_record<DappKey>(user_storage, key_tuple)
+    }
+
+    public fun ensure_has(user_storage: &UserStorage, data: u64) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        key_tuple.push_back(to_bytes(&data));
+        dapp_system::ensure_has_record<DappKey>(user_storage, key_tuple)
+    }
+
+    public fun ensure_has_not(user_storage: &UserStorage, data: u64) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        key_tuple.push_back(to_bytes(&data));
+        dapp_system::ensure_has_not_record<DappKey>(user_storage, key_tuple)
+    }
+  
+
+    public(package) fun delete(user_storage: &mut UserStorage, data: u64, ctx: &TxContext) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        key_tuple.push_back(to_bytes(&data));
+        dapp_system::delete_record<DappKey>(dapp_key::new(), user_storage, key_tuple, vector[b"value"], ctx);
+    }
+
+    public fun get(user_storage: &UserStorage, data: u64): u32 {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        key_tuple.push_back(to_bytes(&data));
+        let value_raw = dapp_system::get_field<DappKey>(user_storage, key_tuple, b"value");
+        let mut value_bcs = sui::bcs::new(value_raw);
+        let value = sui::bcs::peel_u32(&mut value_bcs);
+        value
+    }
+
+    public(package) fun set(user_storage: &mut UserStorage, data: u64, value: u32, ctx: &mut TxContext) {
+        let mut key_tuple = vector::empty();
+        key_tuple.push_back(TABLE_NAME);
+        key_tuple.push_back(to_bytes(&data));
+        let field_names = vector[b"value"];
+        let value_tuple = encode(value);
+        dapp_system::set_record<DappKey>(dapp_key::new(), user_storage, key_tuple, field_names, value_tuple, OFFCHAIN, ctx);
+    }
+
+    public fun encode(value: u32): vector<vector<u8>> {
+        let mut value_tuple = vector::empty();
+        value_tuple.push_back(to_bytes(&value));
+        value_tuple
+    }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/codegen/user_storage_init.move

@@ -0,0 +1,26 @@
+// Copyright (c) Obelisk Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/* Autogenerated file. Do not edit manually. */
+
+module counter::user_storage_init {
+  use dubhe::dapp_service::{DappHub, DappStorage};
+  use dubhe::dapp_system;
+  use counter::dapp_key;
+  use counter::dapp_key::DappKey;
+  use counter::migrate;
+
+  /// Create a UserStorage for the transaction sender within this DApp.
+  /// Must be called once before the user can interact with any user-level resources.
+  /// Aborts if the DApp version does not match this package, the DApp is paused,
+  /// or the framework version has advanced.
+  #[allow(lint(public_entry))]
+  public entry fun init_user_storage(
+      dapp_hub: &DappHub,
+      dapp_storage: &mut DappStorage,
+      ctx: &mut TxContext,
+  ) {
+      dapp_system::ensure_latest_version<DappKey>(dapp_storage, migrate::on_chain_version());
+      dapp_system::create_user_storage(dapp_key::new(), dapp_hub, dapp_storage, ctx);
+  }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/scripts/deploy_hook.move

@@ -0,0 +1,8 @@
+module counter::deploy_hook {
+    use dubhe::dapp_service::DappStorage;
+
+    public(package) fun run(_dapp_storage: &mut DappStorage, _ctx: &mut TxContext) {
+        // No global state to initialize for a UserStorage-based counter.
+        // Each user initializes their own storage via user_storage_init::init_user_storage.
+    }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/scripts/migrate.move

@@ -0,0 +1,8 @@
+module counter::migrate {
+
+  const ON_CHAIN_VERSION: u32 = 1;
+
+  public fun on_chain_version(): u32 {
+    ON_CHAIN_VERSION
+  }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/systems/counter.move

@@ -0,0 +1,13 @@
+module counter::counter_system {
+    use dubhe::dapp_service::UserStorage;
+    use counter::counter1;
+
+    public entry fun inc(user_storage: &mut UserStorage, number: u32, ctx: &mut TxContext) {
+        let curr = if (counter1::has(user_storage)) {
+            counter1::get(user_storage)
+        } else {
+            0u32
+        };
+        counter1::set(user_storage, curr + number, ctx);
+    }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/counter/sources/tests/counter.move

@@ -0,0 +1,28 @@
+#[test_only]
+module counter::counter_test {
+    use sui::test_scenario;
+    use counter::counter_system;
+    use counter::counter1;
+    use dubhe::dapp_system;
+    use counter::dapp_key::DappKey;
+
+    const DEPLOYER: address = @0xA;
+
+    #[test]
+    public fun inc() {
+        let mut scenario = test_scenario::begin(DEPLOYER);
+        {
+            let ctx = test_scenario::ctx(&mut scenario);
+            let mut us = dapp_system::create_user_storage_for_testing<DappKey>(DEPLOYER, ctx);
+
+            counter_system::inc(&mut us, 10, ctx);
+            assert!(counter1::get(&us) == 10);
+
+            counter_system::inc(&mut us, 10, ctx);
+            assert!(counter1::get(&us) == 20);
+
+            dapp_system::destroy_user_storage(us);
+        };
+        scenario.end();
+    }
+}

package/templates/nextjs/sui-farm/packages/contracts/src/harvest/Move.toml

@@ -0,0 +1,14 @@
+[package]
+name = "harvest"
+version = "1.0.0"
+edition = "2024"
+
+[dependencies]
+Dubhe = { local = "../dubhe" }
+
+[addresses]
+harvest = "0x0"
+
+[environments]
+testnet = "4c78adac"
+mainnet = "35834a8a"