bot: Duel listing commands

[rsodre]

After #1 is complete, the live_duels command should be listing duel Ids. Let's make it useful!

Tasks

• [ ] Improve live_duels command
  • [ ] Improve GraphQL query, crossing the Challenge and Duelist models.
  • [ ] Input: page (optional)
  • [ ] Display a compact table containing max 10 duels (configurable)
  • [ ] Pagination links, to display [next] 10 Duels (if available) and/or [previous] 10 Duels
  • [ ] Each line display 1 Duel, including:
  • Truncated Duel id (6 first hex) as a link that triggers the duel command
  • Wager value using a 💰
  • Current round number
  • Challenger Name, Honour, and 👑 badge (from the Duelist model)
  • Challenged Name, Honour, and 👑badge (from the Duelist model)
  • If duelists are wounded, display one blood drop 🩸 for each wound by their side
  • Duel elapsed time
• [ ] Create the duels_by_duelist command. Exactly like live_duels, but filters by duelist (duelist_a or duelist_b). Please do not to duplicate the whole command, create 2 entry points that generate the same result.
  • [ ] Input: address
  • [ ] Input: page (optional)
• [ ] Create the duel command
  • [ ] Create GraphQL query from the Duelist model.
  • [ ] Input: duel_id
  • [ ] Display a compact table containing:
  • Truncated Duel id (6 first hex) as a link to the actual duel on the game
  • Challenger Name, Honour, 👑 badge, and square Profile Picture, with link to trigger the duelist command
  • Challenged Name, Honour, 👑 badge, and square Profile Picture, with link to trigger the duelist command
  • Wager value using a 💰
  • Duel actions so far (see references below)
  • Duel elapsed time

The Challenge and Duelist models:

#[derive(Model, Copy, Drop, Serde)]
struct Challenge {
    #[key]
    duel_id: u128,
    //-------------------------
    duelist_a: ContractAddress, // Challenger
    duelist_b: ContractAddress, // Challenged
    message: felt252,           // message to challenged
    // progress and results
    state: u8,                  // actually a ChallengeState
    round_number: u8,           // current or final
    winner: u8,                 // 0:draw, 1:duelist_a, 2:duelist_b
    // timestamps in unix epoch
    timestamp_start: u64,       // Unix time, started
    timestamp_end: u64,         // Unix time, ended
}

#[derive(Model, Copy, Drop, Serde)]
struct Duelist {
    #[key]
    address: ContractAddress,
    //-----------------------
    name: felt252,
    profile_pic: u8,
    total_duels: u16,
    total_wins: u16,
    total_losses: u16,
    total_draws: u16,
    total_honour: u32,  // sum of al duels Honour
    honour: u8,         // +1 decimal, eg: 100 = 10.0
    timestamp: u64,     // Unix time, 1st registered
}

Notes

A little guide for creating new commands...

• Create a new query in src/graphql/, similar to GetChallenges.graphql
• Create new methods for executing this query src/queries/, similar to getChallenges.ts
• Create a new command src/commands/command_name.ts, similar to live_duels.ts
• Be creative and create a beautiful reply using Discord message embeds (see getChallenges.ts)

Reference

• React hooks used in the game client to fetch duels: useDuel.tsx

• React hooks used in the game client to fetch duel actions: useDuelIcons.tsx

• Profile pictures location (square):

const url = `${process.env.game_url}/profiles/${duelist.profile_pic}_sq.jpg`

• This is the game's Live Duels table:

• This is the game's single Duel view:

[Ugo-X]

Hello, @rsodre would love to be part of this effort! thanks (I am on the OD Hack telegram group, ready to start on Monday )

[Ugo-X]

Hello, @rsodre would love to be part of this effort! it's Monday already, thanks

[Ugo-X]

@rsodre Good day, i would love to contribute to this effort, please can i be assigned this task?

[rsodre]

@rsodre Good day, i would love to contribute to this effort, please can i be assigned this task?

When #1 is ready ;)

[Dprof-in-tech]

Hello @rsodre , its Isaac here. I would love to work on this task