@dorafactory/maci-sdk 0.0.2 → 0.0.4

package/README.md

@@ -1 +1,113 @@
-# Maci Indexer Client
+# Maci Client
+
+MACI (Minimal Anti-Collusion Infrastructure) client SDK for interacting with MACI contracts.
+
+## Installation
+
+```bash
+npm install @dorafactory/maci-sdk
+```
+
+## Usage
+
+### Initialize Client
+
+```typescript
+import { MaciClient } from '@dorafactory/maci-sdk';
+
+const client = new MaciClient({
+  network: 'testnet', // or 'mainnet'
+});
+```
+
+### Query Functions
+
+#### Query Account Balance
+```typescript
+const balance = await client.balanceOf('dora1...');
+```
+
+#### Query Round Information
+```typescript
+// Query round by ID
+const round = await client.getRoundById('dora1...');
+
+// Get list of rounds
+const rounds = await client.getRounds('first', 10);
+
+// Query rounds by status
+const roundsByStatus = await client.getRoundsByStatus('Created', 'first', 10);
+
+// Query rounds by circuit name
+const roundsByCircuit = await client.getRoundsByCircuitName('amaci-qv', 'first', 10);
+
+// Query rounds by operator address
+const roundsByOperator = await client.getRoundsByOperator('dora1...', 'first', 10);
+```
+
+#### Query Operator Information
+```typescript
+// Query operator by address
+const operator = await client.getOperatorByAddress('dora1...');
+
+// Get list of operators
+const operators = await client.getOperators('first', 10);
+```
+
+#### Query Circuit Information
+```typescript
+// Query circuit by name
+const circuit = await client.getCircuitByName('amaci-qv');
+
+// Get all circuits
+const circuits = await client.getCircuits();
+```
+
+#### Query Transaction Information
+```typescript
+// Query transaction by hash
+const transaction = await client.getTransactionByHash('HASH...');
+
+// Get list of transactions
+const transactions = await client.getTransactions('first', 10);
+
+// Query transactions by contract address
+const txByContract = await client.getTransactionsByContractAddress('dora1...', 'first', 10);
+```
+
+#### Query Proof Information
+```typescript
+const proof = await client.getProofByContractAddress('dora1...');
+```
+
+### Contract Interactions
+
+#### Create New Voting Round
+```typescript
+const wallet = await DirectSecp256k1Wallet.fromKey(
+  Buffer.from(privateKey, 'hex'),
+  'dora'
+);
+
+const newRound = await client.createOracleMaciRound({
+  signer: wallet,
+  operatorPubkey: '0e752c...',
+  startVoting: new Date(),
+  endVoting: new Date(new Date().getTime() + 1 * 60 * 1000),
+  title: 'test',
+  description: 'test',
+  link: 'test',
+  maxVoter: '5',
+  maxOption: '5',
+  circuitType: MaciCircuitType.IP1V,
+  whitelistBackendPubkey: 'AoYo...',
+  whitelistEcosystem: 'cosmoshub',
+  whitelistSnapshotHeight: '0',
+  whitelistVotingPowerArgs: {
+    mode: 'slope',
+    slope: '1000000',
+    threshold: '1000000',
+  },
+  feegrantOperator: 'dora1...',
+});
+```

package/dist/index.d.ts

@@ -10,3 +10,4 @@ export { Circuit } from './libs/query';
 export { Operator } from './libs/query';
 export { Proof } from './libs/query';
 export { Transaction } from './libs/query';
+export * from './utils';

package/dist/index.js

@@ -34,7 +34,11 @@ __export(src_exports, {
   Round: () => Round,
   Transaction: () => Transaction,
   circuits: () => circuits,
+  compressPublicKey: () => compressPublicKey,
+  decompressPublicKey: () => decompressPublicKey,
   getDefaultParams: () => getDefaultParams,
+  hexToDecimalString: () => hexToDecimalString,
+  isValidAddress: () => isValidAddress,
   validator_operator_set: () => validator_operator_set
 });
 module.exports = __toCommonJS(src_exports);
@@ -557,6 +561,34 @@ function verifyIsBech32(address) {
 function isValidAddress(address) {
   return address.startsWith("dora") && verifyIsBech32(address) === void 0;
 }
+function hexToDecimalString(hexString) {
+  const decimalString = BigInt("0x" + hexString).toString(10);
+  return decimalString;
+}
+function padWithZerosIfNeeded(inputString) {
+  if (inputString.length === 64) {
+    return inputString;
+  } else if (inputString.length < 64) {
+    const zerosToAdd = 64 - inputString.length;
+    const zeroPadding = "0".repeat(zerosToAdd);
+    return zeroPadding + inputString;
+  }
+  throw new Error("Invalid input string length");
+}
+function decompressPublicKey(compressedPubkey) {
+  const x = compressedPubkey.slice(0, 64);
+  const y = compressedPubkey.slice(64);
+  return {
+    x: hexToDecimalString(x),
+    y: hexToDecimalString(y)
+  };
+}
+function compressPublicKey(decompressedPubkey) {
+  const x = decompressedPubkey[0];
+  const y = decompressedPubkey[1];
+  const compressedPubkey = padWithZerosIfNeeded(x.toString(16)) + padWithZerosIfNeeded(y.toString(16));
+  return compressedPubkey;
+}
 
 // src/libs/query/operator.ts
 var Operator = class {
@@ -3669,18 +3701,6 @@ function getContractParams(type, circuitType, proofSystem, maxVoter, maxOption)
       };
   }
 }
-function hexToDecimalString(hexString) {
-  const decimalString = BigInt("0x" + hexString).toString(10);
-  return decimalString;
-}
-function parsePubkey(publickKey) {
-  const x = publickKey.slice(0, 64);
-  const y = publickKey.slice(64);
-  return {
-    x: hexToDecimalString(x),
-    y: hexToDecimalString(y)
-  };
-}
 
 // src/libs/contract/contract.ts
 var Contract = class {
@@ -3769,7 +3789,7 @@ var Contract = class {
     const end_time = (endVoting.getTime() * 10 ** 6).toString();
     const [{ address }] = await signer.getAccounts();
     const client = await createContractClientByWallet(this.rpcEndpoint, signer);
-    const { x: operatorPubkeyX, y: operatorPubkeyY } = parsePubkey(operatorPubkey);
+    const { x: operatorPubkeyX, y: operatorPubkeyY } = decompressPublicKey(operatorPubkey);
     const {
       parameters,
       groth16ProcessVkey,
@@ -3835,7 +3855,7 @@ var Contract = class {
     const end_time = (endVoting.getTime() * 1e6).toString();
     const [{ address }] = await signer.getAccounts();
     const client = await createContractClientByWallet(this.rpcEndpoint, signer);
-    const { x: operatorPubkeyX, y: operatorPubkeyY } = parsePubkey(operatorPubkey);
+    const { x: operatorPubkeyX, y: operatorPubkeyY } = decompressPublicKey(operatorPubkey);
     const {
       parameters,
       groth16ProcessVkey,
@@ -4175,7 +4195,11 @@ var MaciClient2 = class {
   Round,
   Transaction,
   circuits,
+  compressPublicKey,
+  decompressPublicKey,
   getDefaultParams,
+  hexToDecimalString,
+  isValidAddress,
   validator_operator_set
 });
 //# sourceMappingURL=index.js.map