package org.bouncycastle.crypto.agreement.jpake;

import java.math.BigInteger;

import org.bouncycastle.util.Arrays;

The payload sent/received during the first round of a J-PAKE exchange.

Each JPAKEParticipant creates and sends an instance of this payload to the other JPAKEParticipant. The payload to send should be created via JPAKEParticipant.createRound1PayloadToSend().

Each JPAKEParticipant must also validate the payload received from the other JPAKEParticipant. The received payload should be validated via JPAKEParticipant.validateRound1PayloadReceived(JPAKERound1Payload).

/** * The payload sent/received during the first round of a J-PAKE exchange. * <p> * Each {@link JPAKEParticipant} creates and sends an instance * of this payload to the other {@link JPAKEParticipant}. * The payload to send should be created via * {@link JPAKEParticipant#createRound1PayloadToSend()}. * <p> * Each {@link JPAKEParticipant} must also validate the payload * received from the other {@link JPAKEParticipant}. * The received payload should be validated via * {@link JPAKEParticipant#validateRound1PayloadReceived(JPAKERound1Payload)}. */
public class JPAKERound1Payload {
The id of the JPAKEParticipant who created/sent this payload.
/** * The id of the {@link JPAKEParticipant} who created/sent this payload. */
private final String participantId;
The value of g^x1
/** * The value of g^x1 */
private final BigInteger gx1;
The value of g^x2
/** * The value of g^x2 */
private final BigInteger gx2;
The zero knowledge proof for x1.

This is a two element array, containing {g^v, r} for x1.

/** * The zero knowledge proof for x1. * <p> * This is a two element array, containing {g^v, r} for x1. * </p> */
private final BigInteger[] knowledgeProofForX1;
The zero knowledge proof for x2.

This is a two element array, containing {g^v, r} for x2.

/** * The zero knowledge proof for x2. * <p> * This is a two element array, containing {g^v, r} for x2. * </p> */
private final BigInteger[] knowledgeProofForX2; public JPAKERound1Payload( String participantId, BigInteger gx1, BigInteger gx2, BigInteger[] knowledgeProofForX1, BigInteger[] knowledgeProofForX2) { JPAKEUtil.validateNotNull(participantId, "participantId"); JPAKEUtil.validateNotNull(gx1, "gx1"); JPAKEUtil.validateNotNull(gx2, "gx2"); JPAKEUtil.validateNotNull(knowledgeProofForX1, "knowledgeProofForX1"); JPAKEUtil.validateNotNull(knowledgeProofForX2, "knowledgeProofForX2"); this.participantId = participantId; this.gx1 = gx1; this.gx2 = gx2; this.knowledgeProofForX1 = Arrays.copyOf(knowledgeProofForX1, knowledgeProofForX1.length); this.knowledgeProofForX2 = Arrays.copyOf(knowledgeProofForX2, knowledgeProofForX2.length); } public String getParticipantId() { return participantId; } public BigInteger getGx1() { return gx1; } public BigInteger getGx2() { return gx2; } public BigInteger[] getKnowledgeProofForX1() { return Arrays.copyOf(knowledgeProofForX1, knowledgeProofForX1.length); } public BigInteger[] getKnowledgeProofForX2() { return Arrays.copyOf(knowledgeProofForX2, knowledgeProofForX2.length); } }