@helium/helium-admin-cli 0.11.17 → 0.11.19

package/lib/esm/src/update-council-fanout.js

@@ -0,0 +1,126 @@
+import * as anchor from "@coral-xyz/anchor";
+import { init as initMfan } from "@helium/mini-fanout-sdk";
+import { init as initTuktuk } from "@helium/tuktuk-sdk";
+import { PublicKey } from "@solana/web3.js";
+import os from "os";
+import yargs from "yargs/yargs";
+import { allocateNextTasks, resolveTaskRentRefund } from "./mini-fanout-utils";
+import { loadKeypair, sendInstructionsOrSquadsV4 } from "./utils";
+// HIP 149 Decision 4: update the Advisory Council compensation fanout created by
+// create-council-fanout.ts. Use this on a seat change (add/remove a member) or to
+// change the distribution schedule.
+//
+// Operational rules (see HIP 149 Decision 4, and the header comment on
+// create-council-fanout.ts):
+//   - CRANK before running this on a seat change. `update_mini_fanout_v0` replaces
+//     the share vec wholesale, so accrual (total_owed) for members not carried
+//     forward is lost. Let the current period's distribution run first so accrual
+//     maps to the set that was actually seated when it accrued, then update.
+//   - The fanout's `owner` (a governance multisig vault) must sign this. Pass
+//     `--multisig <governance multisig address>` to route it through Squads V4
+//     as a proposal instead of trying to send it directly.
+//   - Omitting --members leaves the current share set untouched (only the
+//     schedule changes, if given). Omitting --schedule leaves the cron
+//     untouched. Passing neither still re-queues the next distribution task,
+//     which is a valid way to force a reschedule on an already-scheduled fanout
+//     (an idle/unscheduled one should use reschedule-all-mini-fanouts.ts instead,
+//     since that path doesn't need the owner's signature).
+//   - This instruction bakes in the fanout's *current* next_task/next_pre_task
+//     (has_one-checked on-chain) and a task id claimed from the queue's current
+//     bitmap at build time -- both can go stale while a Squads proposal sits
+//     waiting for approval (the cron can self-reschedule to a new next_task, or
+//     another queue_task_v0 call can claim the same id first). Either makes
+//     execution fail on-chain (has_one mismatch or TaskAlreadyExists) rather
+//     than corrupt anything, but the proposal is then permanently dead and must
+//     be rebuilt from a fresh run of this script. Get proposals approved
+//     promptly; if one sits for a while, re-run this script and re-propose
+//     rather than trusting a stale one to still execute.
+export async function run(args = process.argv) {
+    const yarg = yargs(args).options({
+        wallet: {
+            alias: "k",
+            describe: "Anchor wallet keypair (payer; proposer if using --multisig)",
+            default: `${os.homedir()}/.config/solana/id.json`,
+        },
+        url: {
+            alias: "u",
+            default: "http://127.0.0.1:8899",
+            describe: "The solana url",
+        },
+        miniFanout: {
+            type: "string",
+            required: true,
+            describe: "Address of the mini fanout to update",
+        },
+        members: {
+            type: "string",
+            describe: "Comma-separated seated community-member wallet addresses to replace the current share set with (each gets an equal share). Omit to leave shares unchanged.",
+        },
+        schedule: {
+            type: "string",
+            describe: "New cron schedule (sec min hour day month dow) for the distribution crank. Omit to leave the schedule unchanged.",
+        },
+        multisig: {
+            type: "string",
+            describe: "Address of the squads multisig to propose through. Required in practice, since the fanout owner is the governance multisig and must sign this update.",
+        },
+    });
+    const argv = await yarg.argv;
+    process.env.ANCHOR_WALLET = argv.wallet;
+    process.env.ANCHOR_PROVIDER_URL = argv.url;
+    anchor.setProvider(anchor.AnchorProvider.local(argv.url));
+    const provider = anchor.getProvider();
+    const wallet = new anchor.Wallet(loadKeypair(argv.wallet));
+    const program = await initMfan(provider);
+    const tuktukProgram = await initTuktuk(provider);
+    const miniFanout = new PublicKey(argv.miniFanout);
+    const miniFanoutAcc = await program.account.miniFanoutV0.fetch(miniFanout);
+    const shares = argv.members
+        ? argv.members
+            .split(",")
+            .map((m) => m.trim())
+            .filter(Boolean)
+            .map((m) => ({
+            wallet: new PublicKey(m),
+            share: { share: { amount: 1 } },
+        }))
+        : null;
+    if (argv.members && shares.length === 0) {
+        throw new Error("--members was given but resolved to zero wallets");
+    }
+    const { taskId, preTaskId, task, preTask } = await allocateNextTasks(tuktukProgram, miniFanoutAcc.taskQueue);
+    const taskRentRefund = await resolveTaskRentRefund(tuktukProgram, miniFanoutAcc.nextTask, miniFanout, program.programId, wallet.publicKey);
+    const updateIx = await program.methods
+        .updateMiniFanoutV0({
+        newTaskId: taskId,
+        newPreTaskId: preTaskId,
+        shares,
+        schedule: argv.schedule ?? null,
+    })
+        .accountsPartial({
+        owner: miniFanoutAcc.owner,
+        payer: wallet.publicKey,
+        miniFanout,
+        taskQueue: miniFanoutAcc.taskQueue,
+        newTask: task,
+        newPreTask: preTask,
+        taskRentRefund,
+    })
+        .instruction();
+    await sendInstructionsOrSquadsV4({
+        provider,
+        instructions: [updateIx],
+        multisig: argv.multisig ? new PublicKey(argv.multisig) : undefined,
+        signers: [],
+    });
+    console.log("Council fanout updated.");
+    console.log(`  mini fanout: ${miniFanout.toBase58()}`);
+    if (shares) {
+        console.log(`  members (${shares.length}):`);
+        shares.forEach((s) => console.log(`    - ${s.wallet.toBase58()}`));
+    }
+    if (argv.schedule) {
+        console.log(`  schedule: ${argv.schedule}`);
+    }
+}
+//# sourceMappingURL=update-council-fanout.js.map

package/lib/esm/src/update-council-fanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-council-fanout.js","sourceRoot":"","sources":["../../../src/update-council-fanout.ts"],"names":[],"mappings":"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"}

package/lib/esm/src/update-data-credits.js

@@ -1,32 +1,32 @@
-import * as anchor from '@coral-xyz/anchor';
-import { dataCreditsKey, init as initDc } from '@helium/data-credits-sdk';
-import { PublicKey } from '@solana/web3.js';
-import os from 'os';
-import yargs from 'yargs/yargs';
-import { loadKeypair, sendInstructionsOrSquadsV4, } from './utils';
+import * as anchor from "@coral-xyz/anchor";
+import { dataCreditsKey, init as initDc } from "@helium/data-credits-sdk";
+import { PublicKey } from "@solana/web3.js";
+import os from "os";
+import yargs from "yargs/yargs";
+import { loadKeypair, sendInstructionsOrSquadsV4, } from "./utils";
 export async function run(args = process.argv) {
     const yarg = yargs(args).options({
         wallet: {
-            alias: 'k',
-            describe: 'Anchor wallet keypair',
+            alias: "k",
+            describe: "Anchor wallet keypair",
             default: `${os.homedir()}/.config/solana/id.json`,
         },
         url: {
-            alias: 'u',
-            default: 'http://127.0.0.1:8899',
-            describe: 'The solana url',
+            alias: "u",
+            default: "http://127.0.0.1:8899",
+            describe: "The solana url",
         },
         dcMint: {
             required: true,
-            type: 'string',
-            describe: 'Data credits mint address',
+            type: "string",
+            describe: "Data credits mint address",
         },
         newAuthority: {
-            type: 'string',
+            type: "string",
         },
         multisig: {
-            type: 'string',
-            describe: 'Address of the squads multisig to be authority. If not provided, your wallet will be the authority',
+            type: "string",
+            describe: "Address of the squads multisig to be authority. If not provided, your wallet will be the authority",
         },
     });
     const argv = await yarg.argv;
@@ -39,7 +39,7 @@ export async function run(args = process.argv) {
     const instructions = [];
     const dataCredits = dataCreditsKey(new PublicKey(argv.dcMint))[0];
     const dataCreditsAcc = await program.account.dataCreditsV0.fetch(dataCredits);
-    console.log('Data Credits', dataCredits.toBase58());
+    console.log("Data Credits", dataCredits.toBase58());
     console.log(dataCreditsAcc.authority.toBase58());
     instructions.push(await program.methods
         .updateDataCreditsV0({
@@ -61,6 +61,6 @@ export async function run(args = process.argv) {
     });
 }
 function isNull(vehntDelegated) {
-    return vehntDelegated === null || typeof vehntDelegated == 'undefined';
+    return vehntDelegated === null || typeof vehntDelegated == "undefined";
 }
 //# sourceMappingURL=update-data-credits.js.map