Gully Quests

Gully Quests is the on-chain quest system on Gully Chain. A quest says what to do (score at least 5,000 in a season, hold a token, own a .gully name), how many players can complete it, and what each completion pays from a funded pool. The chain itself checks the action through a verifier contract, so a completion is proof, not a claim.

For Gully Studio games, quests are achievements with rewards: the studio creates them, players complete them from inside the game, and the completion is recorded on chain. Advertiser-funded quests use the same contracts through the Offerwall.

#Contracts (testnet)

Other verifiers check .gully names, token holdings, launchpad trades, swaps, bridging and referrals. Reward assets allowed on testnet: ETH, glUSD, USDC.e and WETH.

#The quest struct

quest(uint256 questId) returns:

#Reward modes

#Reading quests from Unity

The SDK has no dedicated quests client yet, so read with JsonRpcClient and Abi:

using GullyLabs.GameSdk;

const string Registry = "0xE3E57e15A9973281A8de2B3bedd512BE8C3813Bb";
var rpc = new JsonRpcClient();

var count = Abi.DecodeUint(Abi.Words(await rpc.EthCallAsync(Registry, Abi.Call("questCount()")))[0]);

// pool left for quest 1
var pool = Abi.DecodeUint(Abi.Words(await rpc.EthCallAsync(Registry, Abi.Call("available(uint256)", Abi.Uint(1))))[0]);

// has this player completed quest 1? (block number, 0 = no)
var done = Abi.DecodeUint(Abi.Words(await rpc.EthCallAsync(Registry,
    Abi.Call("completedAt(uint256,address)", Abi.Uint(1), Abi.Address(player))))[0]);

quest(uint256) returns a struct with two strings at the end. Decode its head with Abi.Words (each field is one 32-byte word in the order of the table above, after the leading tuple offset) and the strings with their offsets, or keep a server-side cache of quest metadata for display.

#Check before the player pays gas

canComplete(questId, account, proof) is a dry run of complete. It returns (bool ok, uint8 reason, bytes32 evidence):

Show the reason in the UI instead of letting a transaction revert.

#Completing a quest

complete(questId, proof) must be sent from the player's account (the registry uses msg.sender), through your ITransactionSender:

byte[] proof = new byte[0]; // most verifiers need no proof; attested quests pass the attestation here
string data = Abi.Call("complete(uint256,bytes)", Abi.Uint(questId), Abi.Uint(64), Abi.DynamicBytes(proof));
string tx = await sender.SendTransactionAsync(new TransactionRequest { To = Registry, Data = data });

A successful completion emits QuestCompleted(questId, account, blockNumber, evidence, reward) and, in Direct mode, pays the reward in the same transaction.

#Arcade score quests

ArcadeScoreVerifier reads GullyArcade.bestScore(seasonId, account), which is already attested when the score is submitted. Its params are abi.encode(uint256 gameId, uint256 seasonId, uint256 minScore); seasonId = 0 means the latest season of the game. So "score 5,000 in Frog Hop" needs no extra proof: submit the score with GullyArcadeClient, then call complete.

#Creating achievement quests

Achievement quests are created by the studio, not by the game client: createQuest with the verifier and params, then fund (ETH) or fundERC20. A 5% fee is taken on funding. The creator can pause, cancel and withdraw unclaimed rewards; the registry owner can never move a pool.