@dorafactory/maci-sdk 0.0.9 → 0.0.11

package/README.md

@@ -116,8 +116,7 @@ const newRound = await client.createOracleMaciRound({
   title: 'Just for fun',
   description: 'some description',
   link: 'https://www.dorafactory.org',
-  maxVoter: '5',
-  maxOption: '5',
+  voteOptionMap: ['option1: A', 'option2: B', 'option3: C'],
   circuitType: MaciCircuitType.IP1V,
   whitelistEcosystem: 'cosmoshub',
   whitelistSnapshotHeight: '0',
@@ -146,3 +145,108 @@ For example, if a voter stakes 100000000 tokens and the slope value is 2500000,
 > The 1,000,000 reference value here is the precision of cosmoshub, which is 6 bits, and doravota, which is 18 bits, so when you want to pick doravota's staker as a whitelist and ask them to pledge 1DORA to convert 1vote, you need to set the scope to 1000000000000000000 (10\*\*18). Note that currently only cosmoshub and doravota are supported as ecosystem options.
 >
 > One detail, here the slope is calculated by rounding down.
+
+#### Sign Up and Vote in a Oracle MACI Round
+
+```typescript
+// 1. Generate MACI account
+const maciAccount = await client.circom.genKeypairFromSign(wallet, address);
+
+// 2. Get Oracle certificate (only for Oracle MACI)
+const certificate = await client.maci.requestOracleCertificate({
+  signer: wallet,
+  ecosystem: 'doravota', // or 'cosmoshub'
+  address,
+  contractAddress: 'dora1...',
+});
+
+// 3. Check Gas Station status
+let gasStationEnable = await client.maci.queryRoundGasStation({
+  contractAddress: 'dora1...',
+});
+
+// Wait for Gas Station to be enabled
+while (!gasStationEnable) {
+  await delay(1000); // Delay 1 second
+  gasStationEnable = await client.maci.queryRoundGasStation({
+    contractAddress: 'dora1...',
+  });
+}
+
+// 4. Sign up for voting
+const signupResponse = await client.maci.signup({
+  signer: wallet,
+  address,
+  contractAddress: 'dora1...',
+  oracleCertificate: {
+    amount: certificate.amount,
+    signature: certificate.signature,
+  },
+  gasStation: true, // Whether to use gas station
+});
+
+// 5. Get user state index
+const stateIdx = await client.maci.getStateIdxByPubKey({
+  contractAddress: 'dora1...',
+  pubKey: maciAccount.pubKey,
+});
+
+// 6. Cast vote
+const voteResponse = await client.maci.vote({
+  signer: wallet,
+  address,
+  stateIdx,
+  contractAddress: 'dora1...',
+  selectedOptions: [
+    { idx: 0, vc: 2 }, // Option index and voting weight
+    { idx: 1, vc: 1 },
+    { idx: 4, vc: 1 },
+  ],
+  operatorCoordPubKey: [
+    BigInt(roundInfo.coordinatorPubkeyX),
+    BigInt(roundInfo.coordinatorPubkeyY),
+  ],
+  gasStation: true,
+});
+```
+
+**Voting Rules:**
+
+MACI supports two voting rules:
+1. 1P1V (One Person One Vote): Each voting weight (vc) directly counts as votes
+2. QV (Quadratic Voting): The sum of squares of voting weights (vc) is consumed as total voting power
+
+Vote options format:
+```typescript
+selectedOptions: [
+  { idx: number, vc: number }, // idx: option index, vc: voting weight
+  ...
+]
+```
+
+Examples:
+```typescript
+// 1P1V mode example (total voting power: 4)
+const options1p1v = [
+  { idx: 0, vc: 2 }, // 2 votes for option 0
+  { idx: 1, vc: 1 }, // 1 vote for option 1
+  { idx: 4, vc: 1 }, // 1 vote for option 4
+]; 
+// Total voting power consumed = 2 + 1 + 1 = 4
+
+// QV mode example (total voting power: 6)
+const optionsQv = [
+  { idx: 0, vc: 2 }, // Consumes 4 voting power (2²)
+  { idx: 1, vc: 1 }, // Consumes 1 voting power (1²)
+  { idx: 2, vc: 1 }, // Consumes 1 voting power (1²)
+];
+// Total voting power consumed = 2² + 1² + 1² = 6
+```
+
+**Important Notes:**
+- Option indices (idx) must be unique
+- Voting weights (vc) must be positive integers
+- In QV mode, total voting power consumed is the sum of squares of voting weights
+- Total voting power consumed cannot exceed user's available voting credits
+- System automatically filters out options with zero voting weight
+- Voting options are automatically sorted by idx

package/dist/index.js

@@ -478,7 +478,7 @@ function getDefaultParams(network = "mainnet") {
         certificateApiEndpoint: "https://vota-certificate-api.dorafactory.org/api/v1",
         registryAddress: "dora1smg5qp5trjdkcekdjssqpjehdjf6n4cjss0clyvqcud3t3u3948s8rmgg4",
         maciCodeId: 106,
-        oracleCodeId: 111,
+        oracleCodeId: 116,
         oracleWhitelistBackendPubkey: "A61YtCv2ibMZmDeM02nEElil8wlHx1tLKogBk5dPgf/Q",
         oracleFeegrantOperator: "dora16s9tljk8dy9ae335yvyzlm8gvkypx9228q8pq8"
       };
@@ -492,7 +492,7 @@ function getDefaultParams(network = "mainnet") {
         certificateApiEndpoint: "https://vota-testnet-certificate-api.dorafactory.org/api/v1",
         registryAddress: "dora13c8aecstyxrhax9znvvh5zey89edrmd2k5va57pxvpe3fxtfsfeqlhsjnd",
         maciCodeId: 107,
-        oracleCodeId: 110,
+        oracleCodeId: 113,
         oracleWhitelistBackendPubkey: "AoYo/zENN/JquagPdG0/NMbWBBYxOM8BVN677mBXJKJQ",
         oracleFeegrantOperator: "dora1xp0twdzsdeq4qg3c64v66552deax8zmvq4zw78"
       };
@@ -4004,8 +4004,7 @@ var Contract = class {
     title,
     description,
     link,
-    maxVoter,
-    maxOption,
+    voteOptionMap,
     circuitType,
     whitelistEcosystem,
     whitelistSnapshotHeight,
@@ -4016,20 +4015,12 @@ var Contract = class {
     const [{ address }] = await signer.getAccounts();
     const client = await createContractClientByWallet(this.rpcEndpoint, signer);
     const { x: operatorPubkeyX, y: operatorPubkeyY } = decompressPublicKey(operatorPubkey);
-    const {
-      parameters,
-      groth16ProcessVkey,
-      groth16TallyVkey,
-      plonkProcessVkey,
-      plonkTallyVkey,
-      maciVoteType,
-      maciCertSystem
-    } = getContractParams(
+    const { maciVoteType, maciCertSystem } = getContractParams(
       "2" /* ORACLE_MACI */,
       circuitType,
       "groth16" /* GROTH16 */,
-      maxVoter,
-      maxOption
+      "0",
+      "0"
     );
     const instantiateResponse = await client.instantiate(
       address,
@@ -4040,23 +4031,17 @@ var Contract = class {
           start_time,
           end_time
         },
-        parameters,
         coordinator: {
           x: operatorPubkeyX,
           y: operatorPubkeyY
         },
-        groth16_process_vkey: groth16ProcessVkey,
-        groth16_tally_vkey: groth16TallyVkey,
-        plonk_process_vkey: plonkProcessVkey,
-        plonk_tally_vkey: plonkTallyVkey,
-        max_vote_options: maxOption,
+        vote_option_map: voteOptionMap,
         whitelist_backend_pubkey: this.whitelistBackendPubkey,
         whitelist_ecosystem: whitelistEcosystem,
         whitelist_snapshot_height: whitelistSnapshotHeight,
         whitelist_voting_power_args: whitelistVotingPowerArgs,
         circuit_type: maciVoteType,
         certification_system: maciCertSystem,
-        qtr_lib: QTR_LIB,
         feegrant_operator: this.feegrantOperator
       },
       `[Oracle MACI] ${title}`,