-
Notifications
You must be signed in to change notification settings - Fork 4
/
MintToChecked.go
259 lines (232 loc) · 8 KB
/
MintToChecked.go
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
// Copyright 2021 github.com/gagliardetto
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package token
import (
"errors"
"fmt"
ag_binary "github.com/gagliardetto/binary"
ag_solanago "github.com/gagliardetto/solana-go"
ag_format "github.com/gagliardetto/solana-go/text/format"
ag_treeout "github.com/gagliardetto/treeout"
)
// Mints new tokens to an account. The native mint does not support minting.
//
// This instruction differs from MintTo in that the decimals value is
// checked by the caller. This may be useful when creating transactions
// offline or within a hardware wallet.
type MintToChecked struct {
// The amount of new tokens to mint.
Amount *uint64
// Expected number of base 10 digits to the right of the decimal place.
Decimals *uint8
// [0] = [WRITE] mint
// ··········· The mint.
//
// [1] = [WRITE] destination
// ··········· The account to mint tokens to.
//
// [2] = [] authority
// ··········· The mint's minting authority.
//
// [3...] = [SIGNER] signers
// ··········· M signer accounts.
Accounts ag_solanago.AccountMetaSlice `bin:"-" borsh_skip:"true"`
Signers ag_solanago.AccountMetaSlice `bin:"-" borsh_skip:"true"`
}
func (obj *MintToChecked) SetAccounts(accounts []*ag_solanago.AccountMeta) error {
obj.Accounts, obj.Signers = ag_solanago.AccountMetaSlice(accounts).SplitFrom(3)
return nil
}
func (slice MintToChecked) GetAccounts() (accounts []*ag_solanago.AccountMeta) {
accounts = append(accounts, slice.Accounts...)
accounts = append(accounts, slice.Signers...)
return
}
// NewMintToCheckedInstructionBuilder creates a new `MintToChecked` instruction builder.
func NewMintToCheckedInstructionBuilder() *MintToChecked {
nd := &MintToChecked{
Accounts: make(ag_solanago.AccountMetaSlice, 3),
Signers: make(ag_solanago.AccountMetaSlice, 0),
}
return nd
}
// SetAmount sets the "amount" parameter.
// The amount of new tokens to mint.
func (inst *MintToChecked) SetAmount(amount uint64) *MintToChecked {
inst.Amount = &amount
return inst
}
// SetDecimals sets the "decimals" parameter.
// Expected number of base 10 digits to the right of the decimal place.
func (inst *MintToChecked) SetDecimals(decimals uint8) *MintToChecked {
inst.Decimals = &decimals
return inst
}
// SetMintAccount sets the "mint" account.
// The mint.
func (inst *MintToChecked) SetMintAccount(mint ag_solanago.PublicKey) *MintToChecked {
inst.Accounts[0] = ag_solanago.Meta(mint).WRITE()
return inst
}
// GetMintAccount gets the "mint" account.
// The mint.
func (inst *MintToChecked) GetMintAccount() *ag_solanago.AccountMeta {
return inst.Accounts[0]
}
// SetDestinationAccount sets the "destination" account.
// The account to mint tokens to.
func (inst *MintToChecked) SetDestinationAccount(destination ag_solanago.PublicKey) *MintToChecked {
inst.Accounts[1] = ag_solanago.Meta(destination).WRITE()
return inst
}
// GetDestinationAccount gets the "destination" account.
// The account to mint tokens to.
func (inst *MintToChecked) GetDestinationAccount() *ag_solanago.AccountMeta {
return inst.Accounts[1]
}
// SetAuthorityAccount sets the "authority" account.
// The mint's minting authority.
func (inst *MintToChecked) SetAuthorityAccount(authority ag_solanago.PublicKey, multisigSigners ...ag_solanago.PublicKey) *MintToChecked {
inst.Accounts[2] = ag_solanago.Meta(authority)
if len(multisigSigners) == 0 {
inst.Accounts[2].SIGNER()
}
for _, signer := range multisigSigners {
inst.Signers = append(inst.Signers, ag_solanago.Meta(signer).SIGNER())
}
return inst
}
// GetAuthorityAccount gets the "authority" account.
// The mint's minting authority.
func (inst *MintToChecked) GetAuthorityAccount() *ag_solanago.AccountMeta {
return inst.Accounts[2]
}
func (inst MintToChecked) Build() *Instruction {
return &Instruction{BaseVariant: ag_binary.BaseVariant{
Impl: inst,
TypeID: ag_binary.TypeIDFromUint8(Instruction_MintToChecked),
}}
}
// ValidateAndBuild validates the instruction parameters and accounts;
// if there is a validation error, it returns the error.
// Otherwise, it builds and returns the instruction.
func (inst MintToChecked) ValidateAndBuild() (*Instruction, error) {
if err := inst.Validate(); err != nil {
return nil, err
}
return inst.Build(), nil
}
func (inst *MintToChecked) Validate() error {
// Check whether all (required) parameters are set:
{
if inst.Amount == nil {
return errors.New("Amount parameter is not set")
}
if inst.Decimals == nil {
return errors.New("Decimals parameter is not set")
}
}
// Check whether all (required) accounts are set:
{
if inst.Accounts[0] == nil {
return errors.New("accounts.Mint is not set")
}
if inst.Accounts[1] == nil {
return errors.New("accounts.Destination is not set")
}
if inst.Accounts[2] == nil {
return errors.New("accounts.Authority is not set")
}
if !inst.Accounts[2].IsSigner && len(inst.Signers) == 0 {
return fmt.Errorf("accounts.Signers is not set")
}
if len(inst.Signers) > MAX_SIGNERS {
return fmt.Errorf("too many signers; got %v, but max is 11", len(inst.Signers))
}
}
return nil
}
func (inst *MintToChecked) EncodeToTree(parent ag_treeout.Branches) {
parent.Child(ag_format.Program(ProgramName, ProgramID)).
//
ParentFunc(func(programBranch ag_treeout.Branches) {
programBranch.Child(ag_format.Instruction("MintToChecked")).
//
ParentFunc(func(instructionBranch ag_treeout.Branches) {
// Parameters of the instruction:
instructionBranch.Child("Params").ParentFunc(func(paramsBranch ag_treeout.Branches) {
paramsBranch.Child(ag_format.Param(" Amount", *inst.Amount))
paramsBranch.Child(ag_format.Param("Decimals", *inst.Decimals))
})
// Accounts of the instruction:
instructionBranch.Child("Accounts").ParentFunc(func(accountsBranch ag_treeout.Branches) {
accountsBranch.Child(ag_format.Meta(" mint", inst.Accounts[0]))
accountsBranch.Child(ag_format.Meta("destination", inst.Accounts[1]))
accountsBranch.Child(ag_format.Meta(" authority", inst.Accounts[2]))
signersBranch := accountsBranch.Child(fmt.Sprintf("signers[len=%v]", len(inst.Signers)))
for i, v := range inst.Signers {
if len(inst.Signers) > 9 && i < 10 {
signersBranch.Child(ag_format.Meta(fmt.Sprintf(" [%v]", i), v))
} else {
signersBranch.Child(ag_format.Meta(fmt.Sprintf("[%v]", i), v))
}
}
})
})
})
}
func (obj MintToChecked) MarshalWithEncoder(encoder *ag_binary.Encoder) (err error) {
// Serialize `Amount` param:
err = encoder.Encode(obj.Amount)
if err != nil {
return err
}
// Serialize `Decimals` param:
err = encoder.Encode(obj.Decimals)
if err != nil {
return err
}
return nil
}
func (obj *MintToChecked) UnmarshalWithDecoder(decoder *ag_binary.Decoder) (err error) {
// Deserialize `Amount`:
err = decoder.Decode(&obj.Amount)
if err != nil {
return err
}
// Deserialize `Decimals`:
err = decoder.Decode(&obj.Decimals)
if err != nil {
return err
}
return nil
}
// NewMintToCheckedInstruction declares a new MintToChecked instruction with the provided parameters and accounts.
func NewMintToCheckedInstruction(
// Parameters:
amount uint64,
decimals uint8,
// Accounts:
mint ag_solanago.PublicKey,
destination ag_solanago.PublicKey,
authority ag_solanago.PublicKey,
multisigSigners []ag_solanago.PublicKey,
) *MintToChecked {
return NewMintToCheckedInstructionBuilder().
SetAmount(amount).
SetDecimals(decimals).
SetMintAccount(mint).
SetDestinationAccount(destination).
SetAuthorityAccount(authority, multisigSigners...)
}