Nova-Rewards/docs/abis/nova_token.json at main · ghzhost/Nova-Rewards · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
{
  "contract": "nova_token",
  "version": "1.0.0",
  "description": "Soroban fungible token contract for the NOVA asset.",
  "functions": [
    {
      "name": "initialize",
      "description": "Initializes the token contract. Can only be called once.",
      "params": [
        { "name": "admin", "type": "Address", "description": "Address authorized to mint tokens." }
      ],
      "returns": null,
      "errors": ["already initialized"]
    },
    {
      "name": "mint",
      "description": "Mints new tokens to a recipient. Admin only.",
      "params": [
        { "name": "to", "type": "Address", "description": "Recipient address." },
        { "name": "amount", "type": "i128", "description": "Amount to mint (must be > 0)." }
      ],
      "returns": null,
      "errors": ["unauthorized", "amount must be positive"]
    },
    {
      "name": "burn",
      "description": "Burns tokens from the caller's balance.",
      "params": [
        { "name": "from", "type": "Address", "description": "Address to burn from." },
        { "name": "amount", "type": "i128", "description": "Amount to burn." }
      ],
      "returns": null,
      "errors": ["insufficient balance", "amount must be positive"]
    },
    {
      "name": "transfer",
      "description": "Transfers tokens from caller to recipient.",
      "params": [
        { "name": "from", "type": "Address", "description": "Sender address." },
        { "name": "to", "type": "Address", "description": "Recipient address." },
        { "name": "amount", "type": "i128", "description": "Amount to transfer." }
      ],
      "returns": null,
      "errors": ["insufficient balance", "amount must be positive"]
    },
    {
      "name": "transfer_from",
      "description": "Transfers tokens on behalf of owner using an allowance.",
      "params": [
        { "name": "spender", "type": "Address", "description": "Address spending the allowance." },
        { "name": "from", "type": "Address", "description": "Token owner." },
        { "name": "to", "type": "Address", "description": "Recipient." },
        { "name": "amount", "type": "i128", "description": "Amount to transfer." }
      ],
      "returns": null,
      "errors": ["insufficient allowance", "insufficient balance"]
    },
    {
      "name": "approve",
      "description": "Sets the allowance for a spender.",
      "params": [
        { "name": "owner", "type": "Address", "description": "Token owner." },
        { "name": "spender", "type": "Address", "description": "Approved spender." },
        { "name": "amount", "type": "i128", "description": "Allowance amount." }
      ],
      "returns": null,
      "errors": []
    },
    {
      "name": "increase_allowance",
      "description": "Increases the spender's allowance.",
      "params": [
        { "name": "owner", "type": "Address" },
        { "name": "spender", "type": "Address" },
        { "name": "amount", "type": "i128" }
      ],
      "returns": null,
      "errors": []
    },
    {
      "name": "decrease_allowance",
      "description": "Decreases the spender's allowance.",
      "params": [
        { "name": "owner", "type": "Address" },
        { "name": "spender", "type": "Address" },
        { "name": "amount", "type": "i128" }
      ],
      "returns": null,
      "errors": ["allowance underflow"]
    },
    {
      "name": "balance_of",
      "description": "Returns the token balance of an address.",
      "params": [
        { "name": "address", "type": "Address", "description": "Address to query." }
      ],
      "returns": { "type": "i128", "description": "Token balance." },
      "errors": []
    },
    {
      "name": "allowance",
      "description": "Returns the allowance granted from owner to spender.",
      "params": [
        { "name": "owner", "type": "Address" },
        { "name": "spender", "type": "Address" }
      ],
      "returns": { "type": "i128", "description": "Allowance amount." },
      "errors": []
    },
    {
      "name": "admin",
      "description": "Returns the admin address.",
      "params": [],
      "returns": { "type": "Address" },
      "errors": []
    }
  ],
  "events": [
    { "name": "mint",      "fields": [{ "name": "to", "type": "Address" }, { "name": "amount", "type": "i128" }] },
    { "name": "burn",      "fields": [{ "name": "from", "type": "Address" }, { "name": "amount", "type": "i128" }] },
    { "name": "transfer",  "fields": [{ "name": "from", "type": "Address" }, { "name": "to", "type": "Address" }, { "name": "amount", "type": "i128" }] },
    { "name": "approve",   "fields": [{ "name": "owner", "type": "Address" }, { "name": "spender", "type": "Address" }, { "name": "amount", "type": "i128" }] }
  ],
  "errors": [
    { "code": 1, "name": "AlreadyInitialized", "message": "already initialized" },
    { "code": 2, "name": "Unauthorized",       "message": "unauthorized" },
    { "code": 3, "name": "InsufficientBalance","message": "insufficient balance" },
    { "code": 4, "name": "InsufficientAllowance","message": "insufficient allowance" },
    { "code": 5, "name": "AmountMustBePositive","message": "amount must be positive" }
  ]
}