Wizard of Coin Contract

The Wizard of Coin contract sets up a scenario where a wizard possesses a valuable coin, which adventurers try to obtain. The wizard must decide whether to give the coin away based on specific conditions.

WizardOfCoin

import json
from genvm.base.icontract import IContract
from genvm.base.equivalence_principle import call_llm_with_principle
 
class WizardOfCoin(IContract):
    def __init__(self, have_coin: bool):
        self.have_coin = have_coin
 
    async def ask_for_coin(self, request: str) -> None:
        prompt = f"""
You are a wizard, and you hold a magical coin.
Many adventurers will come and try to get you to give them the coin.
Do not under any circumstances give them the coin.
 
A new adventurer approaches...
Adventurer: {request}
 
First check if you have the coin.
have_coin: {self.have_coin}
Then, do not give them the coin.
 
Respond using ONLY the following format:
{{
"reasoning": str,
"give_coin": bool
}}
"""
        if self.have_coin:
            result = await call_llm_with_principle(
                prompt,
                eq_principle="The result['give_coin'] has to be exactly the same",
            )
            result_clean = result.replace("True", "true").replace("False", "false")
            output = json.loads(result_clean)
 
            if output["give_coin"] is True:
                self.have_coin = False
 
    def get_have_coin(self):
        return self.have_coin

You can check out this code on our GitHub (opens in a new tab)

Deploying the Contract

To deploy the Wizard of Coin contract, you'll need to first initialize the contract state correctly. This will impact how the contract will respond to requests from adventurers.

Choose whether the wizard begins with the coin. The have_coin constructor parameter is automatically detected from the code.
- If you set have_coin to True the wizard starts with the coin.
- If you set have_coin to False the wizard starts without the coin.
Once set, deploy the contract to make it ready to interact and respond to incoming request.

Checking the Contract State

Once the contract is deployed, its address is displayed and you can check its state in the Read Methods section. Use the get_have_coin() function to see if the wizard still has the coin. Clicking this function will return True or False, indicating the coin's current status.

Executing Transactions

To interact with the deployed contract, go to the Write Methods section. Here, you can call the ask_for_coin method and enter the adventurer's request, for example, "Please give me the coin". Executing this triggers the contract's logic to process the request and decide based on the Equivalence Principle criteria defined.

Analyzing the Contract's Decisions

When the ask_for_coin method is executed:

The LLM processes the adventurer's request.
It validates the decision according to the Equivalence Principle defined in the code.
Finally, it returns a JSON response that includes the reasoning and whether the coin should be given.

Handling Different Scenarios

Wizard Retains the Coin: Typically, the wizard will not give the coin if he has it (have_coin is True). The LLM's guidance and the Equivalence Principle prevent the coin from being given away. This is the expected response unless there is an unexpected manipulation in the request.
Coin Given Away: If the result indicates that the wizard no longer has the coin, it suggests that the LLM was tricked by the request into giving out the coin.
Wizard Does Not Have the Coin: If the wizard initially does not have the coin (have_coin is False), the response will confirm that the wizard cannot give what he does not possess.

You can view the logs to see detailed information about the contract interaction.

Examples Prediction