6b21ad9922
Everywhere including examples, external interop APIs, bindings generators
code and in other valuable places. A couple of `interface{}` usages are
intentionally left in the CHANGELOG.md, documentation and tests.
188 lines
7 KiB
Go
188 lines
7 KiB
Go
package rpcclient
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/nspcc-dev/neo-go/pkg/core/transaction"
|
|
"github.com/nspcc-dev/neo-go/pkg/smartcontract"
|
|
"github.com/nspcc-dev/neo-go/pkg/smartcontract/manifest"
|
|
"github.com/nspcc-dev/neo-go/pkg/util"
|
|
"github.com/nspcc-dev/neo-go/pkg/wallet"
|
|
)
|
|
|
|
// TransferTarget represents target address, token amount and data for transfer.
|
|
type TransferTarget struct {
|
|
Token util.Uint160
|
|
Address util.Uint160
|
|
Amount int64
|
|
Data any
|
|
}
|
|
|
|
// SignerAccount represents combination of the transaction.Signer and the
|
|
// corresponding wallet.Account.
|
|
type SignerAccount struct {
|
|
Signer transaction.Signer
|
|
Account *wallet.Account
|
|
}
|
|
|
|
// NEP17Decimals invokes `decimals` NEP-17 method on the specified contract.
|
|
//
|
|
// Deprecated: please use nep17 package, this method will be removed in future
|
|
// versions.
|
|
func (c *Client) NEP17Decimals(tokenHash util.Uint160) (int64, error) {
|
|
return c.nepDecimals(tokenHash)
|
|
}
|
|
|
|
// NEP17Symbol invokes `symbol` NEP-17 method on the specified contract.
|
|
//
|
|
// Deprecated: please use nep17 package, this method will be removed in future
|
|
// versions.
|
|
func (c *Client) NEP17Symbol(tokenHash util.Uint160) (string, error) {
|
|
return c.nepSymbol(tokenHash)
|
|
}
|
|
|
|
// NEP17TotalSupply invokes `totalSupply` NEP-17 method on the specified contract.
|
|
//
|
|
// Deprecated: please use nep17 package, this method will be removed in future
|
|
// versions. This method is also wrong since tokens can return values overflowing
|
|
// int64.
|
|
func (c *Client) NEP17TotalSupply(tokenHash util.Uint160) (int64, error) {
|
|
return c.nepTotalSupply(tokenHash)
|
|
}
|
|
|
|
// NEP17BalanceOf invokes `balanceOf` NEP-17 method on the specified contract.
|
|
//
|
|
// Deprecated: please use nep17 package, this method will be removed in future
|
|
// versions. This method is also wrong since tokens can return values overflowing
|
|
// int64.
|
|
func (c *Client) NEP17BalanceOf(tokenHash, acc util.Uint160) (int64, error) {
|
|
return c.nepBalanceOf(tokenHash, acc, nil)
|
|
}
|
|
|
|
// NEP17TokenInfo returns full NEP-17 token info.
|
|
//
|
|
// Deprecated: please use Info method from the neptoken subpackage. This method
|
|
// will be removed in future versions.
|
|
func (c *Client) NEP17TokenInfo(tokenHash util.Uint160) (*wallet.Token, error) {
|
|
return c.nepTokenInfo(tokenHash, manifest.NEP17StandardName)
|
|
}
|
|
|
|
// CreateNEP17TransferTx creates an invocation transaction for the 'transfer'
|
|
// method of the given contract (token) to move the specified amount of NEP-17 assets
|
|
// (in FixedN format using contract's number of decimals) to the given account and
|
|
// returns it. The returned transaction is not signed.
|
|
//
|
|
// Deprecated: please use nep17 package, this method will be removed in future
|
|
// versions.
|
|
func (c *Client) CreateNEP17TransferTx(acc *wallet.Account, to util.Uint160,
|
|
token util.Uint160, amount int64, gas int64, data any, cosigners []SignerAccount) (*transaction.Transaction, error) {
|
|
return c.CreateNEP17MultiTransferTx(acc, gas, []TransferTarget{
|
|
{Token: token,
|
|
Address: to,
|
|
Amount: amount,
|
|
Data: data,
|
|
},
|
|
}, cosigners)
|
|
}
|
|
|
|
// CreateNEP17MultiTransferTx creates an invocation transaction for performing
|
|
// NEP-17 transfers from a single sender to multiple recipients with the given
|
|
// data and cosigners. The transaction sender is included with the CalledByEntry
|
|
// scope by default.
|
|
//
|
|
// Deprecated: please use nep17 package (when transferring the same token) or
|
|
// [smartcontract.Builder] (when transferring multiple tokens), this method will
|
|
// be removed in future versions.
|
|
func (c *Client) CreateNEP17MultiTransferTx(acc *wallet.Account, gas int64,
|
|
recipients []TransferTarget, cosigners []SignerAccount) (*transaction.Transaction, error) {
|
|
from := acc.ScriptHash()
|
|
b := smartcontract.NewBuilder()
|
|
for i := range recipients {
|
|
b.InvokeWithAssert(recipients[i].Token, "transfer",
|
|
from, recipients[i].Address, recipients[i].Amount, recipients[i].Data)
|
|
}
|
|
script, err := b.Script()
|
|
if err != nil {
|
|
return nil, fmt.Errorf("failed to create transfer script: %w", err)
|
|
}
|
|
return c.CreateTxFromScript(script, acc, -1, gas, append([]SignerAccount{{
|
|
Signer: transaction.Signer{
|
|
Account: from,
|
|
Scopes: transaction.CalledByEntry,
|
|
},
|
|
Account: acc,
|
|
}}, cosigners...))
|
|
}
|
|
|
|
// CreateTxFromScript creates transaction and properly sets cosigners and NetworkFee.
|
|
// If sysFee <= 0, it is determined via result of `invokescript` RPC. You should
|
|
// initialize network magic with Init before calling CreateTxFromScript.
|
|
//
|
|
// Deprecated: please use actor.Actor API, this method will be removed in future
|
|
// versions.
|
|
func (c *Client) CreateTxFromScript(script []byte, acc *wallet.Account, sysFee, netFee int64,
|
|
cosigners []SignerAccount) (*transaction.Transaction, error) {
|
|
signers, accounts, err := getSigners(acc, cosigners)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("failed to construct tx signers: %w", err)
|
|
}
|
|
if sysFee < 0 {
|
|
result, err := c.InvokeScript(script, signers)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("can't add system fee to transaction: %w", err)
|
|
}
|
|
if result.State != "HALT" {
|
|
return nil, fmt.Errorf("can't add system fee to transaction: bad vm state: %s due to an error: %s", result.State, result.FaultException)
|
|
}
|
|
sysFee = result.GasConsumed
|
|
}
|
|
|
|
tx := transaction.New(script, sysFee)
|
|
tx.Signers = signers
|
|
|
|
tx.ValidUntilBlock, err = c.CalculateValidUntilBlock()
|
|
if err != nil {
|
|
return nil, fmt.Errorf("failed to add validUntilBlock to transaction: %w", err)
|
|
}
|
|
|
|
err = c.AddNetworkFee(tx, netFee, accounts...)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("failed to add network fee: %w", err)
|
|
}
|
|
|
|
return tx, nil
|
|
}
|
|
|
|
// TransferNEP17 creates an invocation transaction that invokes 'transfer' method
|
|
// on the given token to move the specified amount of NEP-17 assets (in FixedN format
|
|
// using contract's number of decimals) to the given account with the data specified and
|
|
// sends it to the network returning just a hash of it. Cosigners argument
|
|
// specifies a set of the transaction cosigners (may be nil or may include sender)
|
|
// with a proper scope and the accounts to cosign the transaction. If cosigning is
|
|
// impossible (e.g. due to locked cosigner's account) an error is returned.
|
|
//
|
|
// Deprecated: please use nep17 package, this method will be removed in future
|
|
// versions.
|
|
func (c *Client) TransferNEP17(acc *wallet.Account, to util.Uint160, token util.Uint160,
|
|
amount int64, gas int64, data any, cosigners []SignerAccount) (util.Uint256, error) {
|
|
tx, err := c.CreateNEP17TransferTx(acc, to, token, amount, gas, data, cosigners)
|
|
if err != nil {
|
|
return util.Uint256{}, err
|
|
}
|
|
|
|
return c.SignAndPushTx(tx, acc, cosigners)
|
|
}
|
|
|
|
// MultiTransferNEP17 is similar to TransferNEP17, buf allows to have multiple recipients.
|
|
//
|
|
// Deprecated: please use nep17 package (when transferring the same token) or
|
|
// [smartcontract.Builder] (when transferring multiple tokens), this method will
|
|
// be removed in future versions.
|
|
func (c *Client) MultiTransferNEP17(acc *wallet.Account, gas int64, recipients []TransferTarget, cosigners []SignerAccount) (util.Uint256, error) {
|
|
tx, err := c.CreateNEP17MultiTransferTx(acc, gas, recipients, cosigners)
|
|
if err != nil {
|
|
return util.Uint256{}, err
|
|
}
|
|
|
|
return c.SignAndPushTx(tx, acc, cosigners)
|
|
}
|