Skip to main content

Join the Market

Welcome to the Join the Market guide. This tutorial will walk you through the steps to join a marketplace using the kalypso-cli, ensuring you can effectively participate and contribute to the Kalypso ecosystem.

📋 Prerequisites​

Before proceeding, ensure you have completed the following:

  • Prover Setup: The previously cloned prover repository contains a standalone executable called kalypso-cli. Ensure that it is available as it simplifies interaction with Kalypso.
  • Registration: You have successfully registered with Kalypso.

📝 Join the Marketplace​

Follow these steps to join a marketplace:

1. Run kalypso-cli​

Execute the kalypso-cli to begin the process of joining a marketplace. This will present you with multiple operation options.

your_terminal
kalypso@kalypso:~/kalypso-cli-tutorial$ ./kalypso-cli 
? Select an operation ›
  Add IVS Key
  Claim Rewards
  Compute PCRs
  Create Marketplace
  Create Proof Request (confidential market)
  Create Proof Request (non confidential market)
  Discard Request
❯ Join Marketplace
  Leave Marketplace
  Native Stake
  Non-Confidential Market PCRS
  Read Attestation
  Read Proof Bytes (beta)
  Register
  Request To Leave Marketplace
  Update Encryption Key
  Whitelist IVS Image
  Whitelist Prover Image

2. Select Join Marketplace​

Choose the Join Marketplace option from the list to initiate the joining process.

operation_selection
? Select an operation ›
❯ Join Marketplace

You will be prompted to enter the following details:

joining_prompts
✔ Select an operation · Join Marketplace

You selected: Join Marketplace - Joins a new marketplace

Enter your private key: [hidden]
Enter RPC URL: <<arbitrum-sepolia-rpc-url>>
Enter Chain ID: 421614
Enter Generator Registry Contract Address: 0xdC33E074d2b055171e56887D79678136B4505Dec
Enter Proof Marketplace Contract Address: 0xfa2AAcA897C4AB956625B72ac678b3CB5450a154
Enter Market ID: 3
Enter compute your machine requires per request: 10
Enter proof generation cost per request: 100000000000
Enter Maximum Time (in blocks) in which you can submit the proof: 1000000000
Compute Provision Warning

Important: For the prompt Enter compute your machine requires per request, set the value to 10 for now. The tool will revert if you try to set it to a higher value. Setting it lower may result in receiving multiple requests in parallel, potentially leading to slashing if requests aren't completed on time.

3. Confirmation​

Upon successfully joining the marketplace, you will receive a transaction hash confirming your participation.

transaction_hash
✔ Joined Marketplace Successfully!
Transaction Hash: 0x123abc...def456
Duplicate Registration Warning

Warning: You cannot join the same marketplace twice. Attempting to do so will result in an error.

⚙️ Optional Configuration​

To streamline the process and avoid repeated prompts, you can add commonly used information to the .env file. This allows kalypso-cli to automatically retrieve these details.

1. Create or Update the .env File​

Add the following entries to your .env file:

Example .env file
RPC_URL=<<arbitrum-sepolia-rpc-url>>
PRIVATE_KEY=<<operator-private-key-without-0x>>
CHAIN_ID=421614
GENERATOR_REGISTRY_ADDRESS=0xdC33E074d2b055171e56887D79678136B4505Dec
PROOF_MARKETPLACE_ADDRESS=0xfa2AAcA897C4AB956625B72ac678b3CB5450a154
ENTITY_KEY_REGISTRY_ADDRESS=0x457d42573096b339ba48be576e9db4fc5f186091
VERIFIER_WRAPPER_ADDRESS=0x8C9B044F1c2c150a068012016836330250C67951
PAYMENT_TOKEN=0x8230d71d809718132C2054704F5E3aF1b86B669C
STAKING_TOKEN=0xB5570D4D39dD20F61dEf7C0d6846790360b89a18
ATTESTATION_UTILITY_URL=http://3.110.146.109:1500
ATTESTATION_VERIFIER_URL=http://13.201.207.60:1400
REWARD_ADDRESS=<<your-reward-address>>
Registration Error Warning

Warning: You cannot join the same marketplace twice with the same operator. Attempting to do so will result in an error.

🚀 Next Steps​

After successfully joining the marketplace, you can proceed to Symbiotic Staking Section to maximize your participation and earnings within the Kalypso ecosystem.