@mocanetwork/privado-js-sdk 1.0.0

package/src/circuits/atomic-query-mtp-v2-on-chain.ts

@@ -0,0 +1,338 @@
+import { Id, Claim } from '@mocanetwork/moca-iden3';
+import { Signature } from '@iden3/js-crypto';
+import { Query, ValueProof, CircuitError, TreeState, GISTProof, ClaimWithMTPProof } from './models';
+import { Hash, Proof } from '@iden3/js-merkletree';
+import {
+  BaseConfig,
+  bigIntArrayToStringArray,
+  existenceToInt,
+  getNodeAuxValue,
+  IStateInfoPubSignals,
+  StatesInfo,
+  prepareCircuitArrayValues,
+  prepareSiblingsStr
+} from './common';
+import { byteDecoder, byteEncoder } from '../utils';
+
+/**
+ * AtomicQueryMTPV2OnChainInputs ZK private inputs for credentialAtomicQueryMTPV2OnChain.circom
+ *
+ * @public
+ * @class AtomicQuerySigV2OnChainInputs
+ * @extends {BaseConfig}
+ */
+export class AtomicQueryMTPV2OnChainInputs extends BaseConfig {
+  // auth
+  id!: Id;
+  profileNonce!: bigint;
+  claimSubjectProfileNonce!: bigint;
+  // claim issued for user
+  claim!: ClaimWithMTPProof;
+  skipClaimRevocationCheck!: boolean;
+  requestID!: bigint;
+
+  currentTimeStamp!: number;
+
+  authClaim!: Claim;
+  authClaimIncMtp!: Proof;
+  authClaimNonRevMtp!: Proof;
+  treeState!: TreeState;
+
+  gistProof!: GISTProof;
+
+  signature!: Signature;
+  challenge!: bigint;
+
+  // query
+  query!: Query;
+
+  /**
+   *  Validate inputs
+   *
+   */
+  validate(): void {
+    if (!this.requestID) {
+      throw new Error(CircuitError.EmptyRequestID);
+    }
+    if (!this.authClaimIncMtp) {
+      throw new Error(CircuitError.EmptyAuthClaimProof);
+    }
+    if (!this.authClaimNonRevMtp) {
+      throw new Error(CircuitError.EmptyAuthClaimNonRevProof);
+    }
+    if (!this.gistProof.proof) {
+      throw new Error(CircuitError.EmptyGISTProof);
+    }
+    if (!this.signature) {
+      throw new Error(CircuitError.EmptyChallengeSignature);
+    }
+    if (this.challenge === null || this.challenge === undefined) {
+      throw new Error(CircuitError.EmptyChallenge);
+    }
+  }
+
+  /**
+   * marshal inputs
+   *
+   * @returns Uint8Array
+   */
+  inputsMarshal(): Uint8Array {
+    this.validate();
+    if (this.query.valueProof) {
+      this.query.validate();
+      this.query.valueProof.validate();
+    }
+
+    const valueProof = this.query.valueProof ?? new ValueProof();
+    const s: Partial<atomicQueryMTPV2OnChainCircuitInputs> = {
+      requestID: this.requestID.toString(),
+      userGenesisID: this.id.bigInt().toString(),
+      profileNonce: this.profileNonce.toString(),
+      claimSubjectProfileNonce: this.claimSubjectProfileNonce?.toString(),
+      issuerID: this.claim.issuerID?.bigInt().toString(),
+      issuerClaim: this.claim.claim?.marshalJson(),
+      issuerClaimMtp:
+        this.claim.incProof?.proof &&
+        prepareSiblingsStr(this.claim.incProof.proof, this.getMTLevel()),
+      issuerClaimClaimsTreeRoot: this.claim.incProof?.treeState?.claimsRoot?.string(),
+      issuerClaimRevTreeRoot: this.claim.incProof?.treeState?.revocationRoot?.string(),
+      issuerClaimRootsTreeRoot: this.claim.incProof?.treeState?.rootOfRoots?.string(),
+      issuerClaimIdenState: this.claim.incProof?.treeState?.state?.string(),
+      issuerClaimNonRevMtp:
+        this.claim.nonRevProof?.proof &&
+        prepareSiblingsStr(this.claim.nonRevProof?.proof, this.getMTLevel()),
+      issuerClaimNonRevClaimsTreeRoot: this.claim.nonRevProof?.treeState?.claimsRoot?.string(),
+      issuerClaimNonRevRevTreeRoot: this.claim.nonRevProof?.treeState?.revocationRoot?.string(),
+      issuerClaimNonRevRootsTreeRoot: this.claim.nonRevProof?.treeState?.rootOfRoots?.string(),
+      issuerClaimNonRevState: this.claim.nonRevProof?.treeState?.state?.string(),
+      claimSchema: this.claim.claim?.getSchemaHash().bigInt().toString(),
+      claimPathMtp: prepareSiblingsStr(valueProof.mtp, this.getMTLevelsClaim()),
+      claimPathValue: valueProof.value.toString(),
+      operator: this.query.operator,
+      slotIndex: this.query.slotIndex,
+      timestamp: this.currentTimeStamp ?? undefined,
+      isRevocationChecked: 1,
+      authClaim: this.authClaim.marshalJson(),
+      authClaimIncMtp:
+        this.authClaimIncMtp && prepareSiblingsStr(this.authClaimIncMtp, this.getMTLevel()),
+      authClaimNonRevMtp:
+        this.authClaimNonRevMtp && prepareSiblingsStr(this.authClaimNonRevMtp, this.getMTLevel()),
+      challenge: this.challenge.toString(),
+      challengeSignatureR8x: this.signature.R8[0].toString(),
+      challengeSignatureR8y: this.signature.R8[1].toString(),
+      challengeSignatureS: this.signature.S.toString(),
+      userClaimsTreeRoot: this.treeState.claimsRoot?.string(),
+      userRevTreeRoot: this.treeState.revocationRoot?.string(),
+      userRootsTreeRoot: this.treeState.rootOfRoots?.string(),
+      userState: this.treeState.state?.string(),
+      gistRoot: this.gistProof.root?.string(),
+      gistMtp: this.gistProof && prepareSiblingsStr(this.gistProof.proof, this.getMTLevelOnChain())
+    };
+
+    if (this.skipClaimRevocationCheck) {
+      s.isRevocationChecked = 0;
+    }
+
+    const nodeAuxNonRev =
+      this.claim.nonRevProof?.proof && getNodeAuxValue(this.claim.nonRevProof.proof);
+    s.issuerClaimNonRevMtpAuxHi = nodeAuxNonRev?.key.bigInt().toString();
+    s.issuerClaimNonRevMtpAuxHv = nodeAuxNonRev?.value.bigInt().toString();
+    s.issuerClaimNonRevMtpNoAux = nodeAuxNonRev?.noAux;
+
+    s.claimPathNotExists = existenceToInt(valueProof.mtp.existence);
+    const nodAuxJSONLD = getNodeAuxValue(valueProof.mtp);
+    s.claimPathMtpNoAux = nodAuxJSONLD.noAux;
+    s.claimPathMtpAuxHi = nodAuxJSONLD.key.bigInt().toString();
+    s.claimPathMtpAuxHv = nodAuxJSONLD.value.bigInt().toString();
+
+    s.claimPathKey = valueProof.path.toString();
+    const values =
+      this.query.values && prepareCircuitArrayValues(this.query.values, this.getValueArrSize());
+    s.value = values && bigIntArrayToStringArray(values);
+
+    const nodeAuxAuth = this.authClaimNonRevMtp && getNodeAuxValue(this.authClaimNonRevMtp);
+    s.authClaimNonRevMtpAuxHi = nodeAuxAuth.key.string();
+    s.authClaimNonRevMtpAuxHv = nodeAuxAuth.value.string();
+    s.authClaimNonRevMtpNoAux = nodeAuxAuth.noAux;
+
+    const globalNodeAux = this.gistProof && getNodeAuxValue(this.gistProof.proof);
+    s.gistMtpAuxHi = globalNodeAux.key.string();
+    s.gistMtpAuxHv = globalNodeAux.value.string();
+    s.gistMtpNoAux = globalNodeAux.noAux;
+
+    return byteEncoder.encode(JSON.stringify(s));
+  }
+}
+
+// atomicQueryMTPV2OnChainCircuitInputs type represents credentialAtomicQueryMTP.circom private inputs required by prover
+interface atomicQueryMTPV2OnChainCircuitInputs {
+  requestID: string;
+  userGenesisID: string;
+  profileNonce: string;
+  claimSubjectProfileNonce: string;
+  issuerID: string;
+  issuerClaim: string[];
+
+  issuerClaimMtp: string[];
+  issuerClaimClaimsTreeRoot: string;
+  issuerClaimRevTreeRoot: string;
+  issuerClaimRootsTreeRoot: string;
+  issuerClaimIdenState: string;
+
+  issuerClaimNonRevClaimsTreeRoot: string;
+  issuerClaimNonRevRevTreeRoot: string;
+  issuerClaimNonRevRootsTreeRoot: string;
+  issuerClaimNonRevState: string;
+  issuerClaimNonRevMtp: string[];
+  issuerClaimNonRevMtpAuxHi?: string;
+  issuerClaimNonRevMtpAuxHv?: string;
+  issuerClaimNonRevMtpNoAux: string;
+
+  isRevocationChecked: number;
+  claimSchema: string;
+  // Query
+  // JSON path
+  claimPathNotExists: number; // 0 for inclusion, 1 for non-inclusion
+  claimPathMtp: string[];
+  claimPathMtpNoAux: string; // 1 if aux node is empty,
+  // 0 if non-empty or for inclusion proofs
+  claimPathMtpAuxHi: string; // 0 for inclusion proof
+  claimPathMtpAuxHv: string; // 0 for inclusion proof
+  claimPathKey: string; // hash of path in merklized json-ld document
+  claimPathValue: string; // value in this path in merklized json-ld document
+
+  operator: number;
+  slotIndex: number;
+  timestamp: number;
+  value: string[];
+
+  // AuthClaim proof of inclusion
+  authClaim: string[];
+  authClaimIncMtp: string[];
+
+  // AuthClaim non revocation proof
+  authClaimNonRevMtp: string[];
+  authClaimNonRevMtpAuxHi: string;
+  authClaimNonRevMtpAuxHv: string;
+  authClaimNonRevMtpNoAux: string;
+
+  challenge: string;
+  challengeSignatureR8x: string;
+  challengeSignatureR8y: string;
+  challengeSignatureS: string;
+
+  // User State
+  userClaimsTreeRoot: string;
+  userRevTreeRoot: string;
+  userRootsTreeRoot: string;
+  userState: string;
+
+  // Global on-cain state
+  gistRoot: string;
+  gistMtp: string[];
+  gistMtpAuxHi: string;
+  gistMtpAuxHv: string;
+  gistMtpNoAux: string;
+}
+
+/**
+ *
+ * public signals
+ * @public
+ * @class AtomicQueryMTPV2OnChainPubSignals
+ * @extends {BaseConfig}
+ */
+export class AtomicQueryMTPV2OnChainPubSignals extends BaseConfig implements IStateInfoPubSignals {
+  requestID!: bigint;
+  userID!: Id;
+  issuerID!: Id;
+  issuerClaimIdenState!: Hash;
+  issuerClaimNonRevState!: Hash;
+  timestamp!: number;
+  merklized!: number;
+  isRevocationChecked!: number; // 0 revocation not check, // 1 for check revocation
+  circuitQueryHash!: bigint;
+  challenge!: bigint;
+  gistRoot!: Hash;
+
+  /**
+   *
+   * // PubSignalsUnmarshal unmarshal credentialAtomicQueryMTPV2OnChain.circom public signals array to AtomicQueryMTPPubSignals
+   * @param {Uint8Array} data
+   * @returns AtomicQuerySigV2PubSignals
+   */
+  pubSignalsUnmarshal(data: Uint8Array): AtomicQueryMTPV2OnChainPubSignals {
+    // expected order:
+    // merklized
+    // userID
+    // circuitQueryHash
+    // requestID
+    // challenge
+    // gistRoot
+    // issuerID
+    // issuerClaimIdenState
+    // isRevocationChecked
+    // issuerClaimNonRevState
+    // timestamp
+
+    const sVals: string[] = JSON.parse(byteDecoder.decode(data));
+    let fieldIdx = 0;
+
+    // -- merklized
+    this.merklized = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    //  - userID
+    this.userID = Id.fromBigInt(BigInt(sVals[fieldIdx]));
+    fieldIdx++;
+
+    //  - circuitQueryHash
+    this.circuitQueryHash = BigInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - requestID
+    this.requestID = BigInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - challenge
+    this.challenge = BigInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - gistRoot
+    this.gistRoot = Hash.fromString(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - issuerID
+    this.issuerID = Id.fromBigInt(BigInt(sVals[fieldIdx]));
+    fieldIdx++;
+
+    // - issuerClaimIdenState
+    this.issuerClaimIdenState = Hash.fromString(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - isRevocationChecked
+    this.isRevocationChecked = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - issuerClaimNonRevState
+    this.issuerClaimNonRevState = Hash.fromString(sVals[fieldIdx]);
+    fieldIdx++;
+
+    //  - timestamp
+    this.timestamp = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    return this;
+  }
+
+  /** {@inheritDoc IStateInfoPubSignals.getStatesInfo} */
+  getStatesInfo(): StatesInfo {
+    return {
+      states: [
+        { id: this.issuerID, state: this.issuerClaimIdenState },
+        { id: this.issuerID, state: this.issuerClaimNonRevState }
+      ],
+      gists: [{ id: this.userID, root: this.gistRoot }]
+    };
+  }
+}

package/src/circuits/atomic-query-mtp-v2.ts

@@ -0,0 +1,283 @@
+import { Id, SchemaHash } from '@mocanetwork/moca-iden3';
+import { Query, ClaimWithMTPProof, ValueProof, CircuitError } from './models';
+import { Hash } from '@iden3/js-merkletree';
+import {
+  BaseConfig,
+  bigIntArrayToStringArray,
+  existenceToInt,
+  getNodeAuxValue,
+  prepareCircuitArrayValues,
+  prepareSiblingsStr
+} from './common';
+import { byteDecoder, byteEncoder } from '../utils';
+
+/**
+ * AtomicQueryMTPInputs ZK private inputs for credentialAtomicQueryMTP.circom
+ *
+ * @public
+ * @class AtomicQueryMTPV2Inputs
+ * @extends {BaseConfig}
+ */
+export class AtomicQueryMTPV2Inputs extends BaseConfig {
+  // auth
+  id!: Id;
+  profileNonce!: bigint;
+  claimSubjectProfileNonce!: bigint;
+  // claim issued for user
+  claim!: ClaimWithMTPProof;
+  skipClaimRevocationCheck!: boolean;
+  requestID!: bigint;
+
+  currentTimeStamp!: number;
+
+  // query
+  query!: Query;
+
+  /**
+   * Validate AtomicQueryMTPV2 inputs
+   *
+   */
+  validate(): void {
+    if (!this.requestID) {
+      throw new Error(CircuitError.EmptyRequestID);
+    }
+  }
+
+  /**
+   *
+   * Inputs marshalling
+   * @returns {Uint8Array}
+   */
+  inputsMarshal(): Uint8Array {
+    this.validate();
+    if (this.query.valueProof) {
+      this.query.validate();
+      this.query.valueProof.validate();
+    }
+
+    const valueProof = this.query.valueProof ?? new ValueProof();
+
+    const s: Partial<AtomicQueryMTPV2CircuitInputs> = {
+      requestID: this.requestID.toString(),
+      userGenesisID: this.id.bigInt().toString(),
+      profileNonce: this.profileNonce?.toString(),
+      claimSubjectProfileNonce: this.claimSubjectProfileNonce?.toString(),
+      issuerID: this.claim.issuerID?.bigInt().toString(),
+      issuerClaim: this.claim.claim?.marshalJson(),
+      issuerClaimMtp:
+        this.claim.incProof?.proof &&
+        prepareSiblingsStr(this.claim.incProof.proof, this.getMTLevel()),
+      issuerClaimClaimsTreeRoot: this.claim.incProof?.treeState?.claimsRoot?.bigInt().toString(),
+      issuerClaimRevTreeRoot: this.claim.incProof?.treeState?.revocationRoot?.bigInt().toString(),
+      issuerClaimRootsTreeRoot: this.claim.incProof?.treeState?.rootOfRoots?.bigInt().toString(),
+      issuerClaimIdenState: this.claim.incProof?.treeState?.state?.bigInt().toString(),
+      issuerClaimNonRevMtp:
+        this.claim.nonRevProof?.proof &&
+        prepareSiblingsStr(this.claim.nonRevProof.proof, this.getMTLevel()),
+      issuerClaimNonRevClaimsTreeRoot: this.claim.nonRevProof?.treeState?.claimsRoot
+        ?.bigInt()
+        .toString(),
+      issuerClaimNonRevRevTreeRoot: this.claim.nonRevProof?.treeState?.revocationRoot
+        ?.bigInt()
+        .toString(),
+      issuerClaimNonRevRootsTreeRoot: this.claim.nonRevProof?.treeState?.rootOfRoots
+        ?.bigInt()
+        .toString(),
+      issuerClaimNonRevState: this.claim.nonRevProof?.treeState?.state?.bigInt().toString(),
+      claimSchema: this.claim.claim?.getSchemaHash().bigInt().toString(),
+      claimPathMtp: prepareSiblingsStr(valueProof.mtp, this.getMTLevelsClaim()),
+      claimPathValue: valueProof.value.toString(),
+      operator: this.query.operator,
+      slotIndex: this.query.slotIndex,
+      timestamp: this.currentTimeStamp
+    };
+
+    const nodeAux = getNodeAuxValue(this.claim.nonRevProof?.proof);
+    s.issuerClaimNonRevMtpAuxHi = nodeAux?.key.bigInt().toString();
+    s.issuerClaimNonRevMtpAuxHv = nodeAux?.value.bigInt().toString();
+    s.issuerClaimNonRevMtpNoAux = nodeAux?.noAux;
+
+    s.claimPathNotExists = existenceToInt(valueProof.mtp.existence);
+    const nodAuxJSONLD = getNodeAuxValue(valueProof.mtp);
+    s.claimPathMtpNoAux = nodAuxJSONLD.noAux;
+    s.claimPathMtpAuxHi = nodAuxJSONLD.key.bigInt().toString();
+    s.claimPathMtpAuxHv = nodAuxJSONLD.value.bigInt().toString();
+
+    s.claimPathKey = valueProof.path.toString();
+
+    if (this.skipClaimRevocationCheck) {
+      s.isRevocationChecked = 0;
+    } else {
+      s.isRevocationChecked = 1;
+    }
+
+    const values =
+      this.query.values && prepareCircuitArrayValues(this.query.values, this.getValueArrSize());
+
+    s.value = bigIntArrayToStringArray(values);
+
+    return byteEncoder.encode(JSON.stringify(s));
+  }
+}
+
+// stateTransitionInputsInternal type represents credentialAtomicQueryMTP.circom private inputs required by prover
+interface AtomicQueryMTPV2CircuitInputs {
+  requestID: string;
+  userGenesisID: string;
+  profileNonce: string;
+  claimSubjectProfileNonce: string;
+  issuerID: string;
+  issuerClaim?: string[];
+  issuerClaimMtp: string[];
+  issuerClaimClaimsTreeRoot?: string;
+  issuerClaimRevTreeRoot?: string;
+  issuerClaimRootsTreeRoot?: string;
+  issuerClaimIdenState?: string;
+  issuerClaimNonRevClaimsTreeRoot?: string;
+  issuerClaimNonRevRevTreeRoot?: string;
+  issuerClaimNonRevRootsTreeRoot?: string;
+  issuerClaimNonRevState?: string;
+  issuerClaimNonRevMtp: string[];
+  issuerClaimNonRevMtpAuxHi?: string;
+  issuerClaimNonRevMtpAuxHv?: string;
+  issuerClaimNonRevMtpNoAux: string;
+  isRevocationChecked: number;
+  claimSchema: string;
+  claimPathNotExists: number;
+  claimPathMtp: string[];
+  claimPathMtpNoAux: string;
+  claimPathMtpAuxHi?: string;
+  claimPathMtpAuxHv?: string;
+  claimPathKey: string;
+  claimPathValue: string;
+  operator: number;
+  slotIndex: number;
+  timestamp: number;
+  value: string[];
+}
+
+/**
+ * Public signals
+ *
+ * @public
+ * @class AtomicQueryMTPV2PubSignals
+ * @extends {BaseConfig}
+ */
+export class AtomicQueryMTPV2PubSignals extends BaseConfig {
+  requestID!: bigint;
+  userID!: Id;
+  issuerID!: Id;
+  issuerClaimIdenState!: Hash;
+  issuerClaimNonRevState!: Hash;
+  claimSchema!: SchemaHash;
+  slotIndex!: number;
+  operator!: number;
+  value: bigint[] = [];
+  timestamp!: number;
+  merklized!: number;
+  claimPathKey!: bigint;
+  // 0 for inclusion, 1 for non-inclusion
+  claimPathNotExists!: number;
+  // 0 revocation not check, // 1 for check revocation
+  isRevocationChecked!: number;
+
+  /**
+   * PubSignalsUnmarshal unmarshal credentialAtomicQueryMTP.circom public signals array to AtomicQueryMTPPubSignals
+   *
+   * @param {Uint8Array} data
+   * @returns AtomicQueryMTPV2PubSignals
+   */
+  pubSignalsUnmarshal(data: Uint8Array): AtomicQueryMTPV2PubSignals {
+    // expected order:
+    // merklized
+    // userID
+    // requestID
+    // issuerID
+    // issuerClaimIdenState
+    // issuerClaimNonRevState
+    // timestamp
+    // claimSchema
+    // claimPathNotExists
+    // claimPathKey
+    // slotIndex
+    // operator
+    // value
+
+    // 12 is a number of fields in AtomicQueryMTPV2PubSignals before values, values is last element in the proof and
+    // it is length could be different base on the circuit configuration. The length could be modified by set value
+    // in ValueArraySize
+    const fieldLength = 13;
+
+    const sVals: string[] = JSON.parse(byteDecoder.decode(data));
+
+    if (sVals.length !== fieldLength + this.getValueArrSize()) {
+      throw new Error(
+        `invalid number of Output values expected ${fieldLength + this.getValueArrSize()} got ${
+          sVals.length
+        }`
+      );
+    }
+
+    let fieldIdx = 0;
+
+    // -- merklized
+    this.merklized = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    //  - userID
+    this.userID = Id.fromBigInt(BigInt(sVals[fieldIdx]));
+    fieldIdx++;
+
+    // - requestID
+    this.requestID = BigInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - issuerID
+    this.issuerID = Id.fromBigInt(BigInt(sVals[fieldIdx]));
+    fieldIdx++;
+
+    // - issuerClaimIdenState
+    this.issuerClaimIdenState = Hash.fromString(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - isRevocationChecked
+    this.isRevocationChecked = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - issuerClaimNonRevState
+    this.issuerClaimNonRevState = Hash.fromString(sVals[fieldIdx]);
+    fieldIdx++;
+
+    //  - timestamp
+    this.timestamp = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    //  - claimSchema
+    this.claimSchema = SchemaHash.newSchemaHashFromInt(BigInt(sVals[fieldIdx]));
+    fieldIdx++;
+
+    // - ClaimPathNotExists
+    this.claimPathNotExists = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - ClaimPathKey
+    this.claimPathKey = BigInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - slotIndex
+    this.slotIndex = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    // - operator
+    this.operator = parseInt(sVals[fieldIdx]);
+    fieldIdx++;
+
+    //  - values
+    for (let index = 0; index < this.getValueArrSize(); index++) {
+      this.value.push(BigInt(sVals[fieldIdx]));
+      fieldIdx++;
+    }
+
+    return this;
+  }
+}