Transactions & Payloads

The exposed transactions CLI commands and ticket payloads by the Bet module.

Place Bet

The below transaction can be used to place a bet on the blockchain.

Command

sged tx bet wager [uid] [amount] [ticket] --flags

The below table specifies the details of the arguments used in the above transaction:

Argument	Description	Type	Validation	Example
uid	Unique Identifier of a the bet	string	Required Valid UUID	0435e5b6-635f-11ed-90a6-bb470175dfce
amount	It is the total wager amount (contains bet fee also)	Integer	Positive Should be greater than the minimum bet amount for the market	100000000
ticket	Used for market verification.	String (JWT token)	Cannot be empty Cannot contain space (More validations will be added in the future)	1eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiI5OTkxYzYwZi0yMDI1LTQ4Y2UtYWU3OS0xZGMxMTBmMTY5OTkiLCJ4aWQiOiJCZXRPZGQiLCJuYW1lIjoiMSIsImJldF9ldmVudF91aWQiOiI1NTMxYzYwZi0yMDI1

Argument

Description

Type

Validation

Example

uid

Unique Identifier of a the bet

string

Required
Valid UUID

0435e5b6-635f-11ed-90a6-bb470175dfce

amount

It is the total wager amount (contains bet fee also)

Integer

Positive
Should be greater than the minimum bet amount for the market

100000000

ticket

Used for market verification.

String (JWT token)

Cannot be empty
Cannot contain space (More validations will be added in the future)

1eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiI5OTkxYzYwZi0yMDI1LTQ4Y2UtYWU3OS0xZGMxMTBmMTY5OTkiLCJ4aWQiOiJCZXRPZGQiLCJuYW1lIjoiMSIsImJldF9ldmVudF91aWQiOiI1NTMxYzYwZi0yMDI1

Payload

The payload for the place-bet transaction is as follows:

{
 "selected_odds": {
   "uid": "9991c60f-2025-48ce-ae79-1dc110f16990",
   "market_uid": "5531c60f-2025-48ce-ae79-1dc110f16007",
   "value": "2.0",
   "max_loss_multiplier": "0.1"
 },
 "kyc_data": {
   "ignore": true,
   "approved": true,
   "id": "userAddress"
 },
 "odds_type": 1,
 "exp": 1667863498866062000,
 "iat": 1667827498,
 "iss": "Oracle",
 "sub": "PlaceBet"
}

The values in the payload should be changed according to the data.

The details of the payload parameters are stated in the below table:

Params	Description	Type	Validation	Example
selected_odds	The selected odds for the bet		Odds Value will be validated according to the OddsType selected in the bet placement message. there are three types of validation according to the Decimal, Fractional and Moenyline odds	{ "uid": "9991c60f-2025-48ce-ae79-1dc110f16990", "market_uid": "5531c60f-2025-48ce-ae79-1dc110f16007", "value": "2.0"}
uid	Unique identifier of the odds on which the bet should be placed		Cannot be empty Cannot contain space Should be a proper UUID (https://www.uuidtools.com/decode)	"uid": "2231c60f-2025-48ce-ae79-1dc110f16444"
value	Value of the odd selected by the bettor	sdk.Dec	Cannot be <= 1	"value": "5.0"
market_uid	Unique identifier of the market on which the bet should be placed		Cannot be empty Cannot contain space Should be a proper UUID (https://www.uuidtools.com/decode)	"market_uid": "5531c60f-2025-48ce-ae79-1dc110f16001
kyc_data	Data related to the user kyc	KycData		{ "ignore": true, "approved": true, "id": "userID" }
kyc_ignore	If indend to disable the KYC validation should be set as true	boolean		false
kyc_approved	Tells whether KYC is approved for the user or not	boolean		true
kyc_id	Account address of the user	string	A valid address	sge1na4f4c8m9hzlxqttl4jfnnyhsd94hsg9ykqxez
max_loss_multiplier	A coefficient for maximum loss prevention	string	should be less than one	0.5
odds_type	Type of the odds	uint32		1
iat	Epoch timestamp for issuance of the ticket by oracle in seconds	int64		1657270827
exp	Ticket-expiration epoch timestamp in seconds	int64		1657270827
iss	Issuer of the ticket	string		“Oracle”
sub	Subject of the payload or mostly the name of the transaction	string		“Place Bet”

Params

Description

Type

Validation

Example

selected_odds

The selected odds for the bet

Odds Value will be validated according to the OddsType selected in the bet placement message. there are three types of validation according to the Decimal, Fractional and Moenyline odds

{ "uid": "9991c60f-2025-48ce-ae79-1dc110f16990", "market_uid": "5531c60f-2025-48ce-ae79-1dc110f16007", "value": "2.0"}

uid

Unique identifier of the odds on which the bet should be placed

Cannot be empty
Cannot contain space
Should be a proper UUID (https://www.uuidtools.com/decode)

"uid": "2231c60f-2025-48ce-ae79-1dc110f16444"

value

Value of the odd selected by the bettor

sdk.Dec

Cannot be <= 1

"value": "5.0"

market_uid

Unique identifier of the market on which the bet should be placed

Cannot be empty
Cannot contain space
Should be a proper UUID (https://www.uuidtools.com/decode)

"market_uid": "5531c60f-2025-48ce-ae79-1dc110f16001

kyc_data

Data related to the user kyc

KycData

{ "ignore": true, "approved": true, "id": "userID" }

kyc_ignore

If indend to disable the KYC validation should be set as true

boolean

false

kyc_approved

Tells whether KYC is approved for the user or not

boolean

true

kyc_id

Account address of the user

string

A valid address

sge1na4f4c8m9hzlxqttl4jfnnyhsd94hsg9ykqxez

max_loss_multiplier

A coefficient for maximum loss prevention

string

should be less than one

0.5

odds_type

Type of the odds

uint32

iat

Epoch timestamp for issuance of the ticket by oracle in seconds

int64

1657270827

exp

Ticket-expiration epoch timestamp in seconds

int64

1657270827

iss

Issuer of the ticket

string

“Oracle”

sub

Subject of the payload or mostly the name of the transaction

string

“Place Bet”

Last updated 6 months ago