From a10630dfff11e2f83ced15041a709c42da930012 Mon Sep 17 00:00:00 2001 From: banasa44 Date: Mon, 21 Jul 2025 11:47:33 +0200 Subject: [PATCH] feat(_code-samples): WiP add go tx examples implementation and get-started section --- _code-samples/get-started/go/base/rpc/main.go | 24 + _code-samples/get-started/go/base/ws/main.go | 24 + .../get-started/go/get-acc-info/rpc/main.go | 59 ++ .../get-started/go/get-acc-info/ws/main.go | 74 +++ _code-samples/get-started/go/go.mod | 24 + _code-samples/get-started/go/go.sum | 58 ++ _code-samples/get-tx/go/go.mod | 23 + _code-samples/get-tx/go/go.sum | 56 ++ _code-samples/get-tx/go/main.go | 45 ++ _code-samples/issue-a-token/go/go.mod | 24 + _code-samples/issue-a-token/go/go.sum | 58 ++ _code-samples/issue-a-token/go/rpc/main.go | 523 +++++++++++++++++ _code-samples/issue-a-token/go/ws/main.go | 529 ++++++++++++++++++ _code-samples/send-xrp/go/go.mod | 23 +- _code-samples/send-xrp/go/go.sum | 58 ++ _code-samples/send-xrp/go/rpc/main.go | 112 +++- _code-samples/send-xrp/go/ws/main.go | 121 +++- _code-samples/use-tickets/go/rpc/main.go | 7 +- 18 files changed, 1833 insertions(+), 9 deletions(-) create mode 100644 _code-samples/get-started/go/base/rpc/main.go create mode 100644 _code-samples/get-started/go/base/ws/main.go create mode 100644 _code-samples/get-started/go/get-acc-info/rpc/main.go create mode 100644 _code-samples/get-started/go/get-acc-info/ws/main.go create mode 100644 _code-samples/get-started/go/go.mod create mode 100644 _code-samples/get-started/go/go.sum create mode 100644 _code-samples/get-tx/go/go.mod create mode 100644 _code-samples/get-tx/go/go.sum create mode 100644 _code-samples/get-tx/go/main.go create mode 100644 _code-samples/issue-a-token/go/go.mod create mode 100644 _code-samples/issue-a-token/go/go.sum create mode 100644 _code-samples/issue-a-token/go/rpc/main.go create mode 100644 _code-samples/issue-a-token/go/ws/main.go create mode 100644 _code-samples/send-xrp/go/go.sum diff --git a/_code-samples/get-started/go/base/rpc/main.go b/_code-samples/get-started/go/base/rpc/main.go new file mode 100644 index 0000000000..61ec4c0101 --- /dev/null +++ b/_code-samples/get-started/go/base/rpc/main.go @@ -0,0 +1,24 @@ +package main + +import ( + "github.com/Peersyst/xrpl-go/xrpl/queries/utility" + "github.com/Peersyst/xrpl-go/xrpl/rpc" +) + +func main() { + // Define the network client configuration + cfg, err := rpc.NewClientConfig("https://s.altnet.rippletest.net:51234/") + if err != nil { + panic(err) + } + + // Initiate the network client + client := rpc.NewClient(cfg) + + // Ping the network (used to avoid Go unused variable error, but useful to check connectivity) + _, err = client.Ping(&utility.PingRequest{}) + if err != nil { + panic(err) + } + +} diff --git a/_code-samples/get-started/go/base/ws/main.go b/_code-samples/get-started/go/base/ws/main.go new file mode 100644 index 0000000000..1d16541391 --- /dev/null +++ b/_code-samples/get-started/go/base/ws/main.go @@ -0,0 +1,24 @@ +package main + +import ( + "fmt" + + "github.com/Peersyst/xrpl-go/xrpl/websocket" +) + +func main() { + + // Define the network client + client := websocket.NewClient(websocket.NewClientConfig().WithHost("wss://s.altnet.rippletest.net:51233")) + + // Disconnect the client when done. (Defer executes at the end of the function) + defer client.Disconnect() + + // Connect to the network + if err := client.Connect(); err != nil { + fmt.Println(err) + return + } + + // ... custom code goes here +} diff --git a/_code-samples/get-started/go/get-acc-info/rpc/main.go b/_code-samples/get-started/go/get-acc-info/rpc/main.go new file mode 100644 index 0000000000..792e89a3ed --- /dev/null +++ b/_code-samples/get-started/go/get-acc-info/rpc/main.go @@ -0,0 +1,59 @@ +package main + +import ( + "fmt" + + "github.com/Peersyst/xrpl-go/pkg/crypto" + "github.com/Peersyst/xrpl-go/xrpl/faucet" + "github.com/Peersyst/xrpl-go/xrpl/queries/account" + "github.com/Peersyst/xrpl-go/xrpl/queries/common" + "github.com/Peersyst/xrpl-go/xrpl/queries/ledger" + "github.com/Peersyst/xrpl-go/xrpl/rpc" + "github.com/Peersyst/xrpl-go/xrpl/wallet" +) + +func main() { + // Define the network client with a faucet provider + cfg, err := rpc.NewClientConfig( + "https://s.altnet.rippletest.net:51234/", + rpc.WithFaucetProvider(faucet.NewTestnetFaucetProvider()), + ) + if err != nil { + panic(err) + } + client := rpc.NewClient(cfg) + + // Create a new wallet + w, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Println(err) + return + } + fmt.Println("New wallet created:") + fmt.Println("Address:", w.ClassicAddress) + + // Fund the wallet with testnet XRP + if err := client.FundWallet(&w); err != nil { + fmt.Println(err) + return + } + + // Get info from the ledger about the address we just funded + acc_info, err := client.GetAccountInfo(&account.InfoRequest{ + Account: w.GetAddress(), + }) + if err != nil { + fmt.Println(err) + return + } + fmt.Println("Account Balance:", acc_info.AccountData.Balance) + fmt.Println("Account Sequence:", acc_info.AccountData.Sequence) + + // Get info about the ledger + ledger, err := client.GetLedger(&ledger.Request{LedgerIndex: common.Current}) + if err != nil { + fmt.Println(err) + return + } + fmt.Println("Ledger Index:", ledger.Ledger.LedgerIndex) +} diff --git a/_code-samples/get-started/go/get-acc-info/ws/main.go b/_code-samples/get-started/go/get-acc-info/ws/main.go new file mode 100644 index 0000000000..f4ef0ff129 --- /dev/null +++ b/_code-samples/get-started/go/get-acc-info/ws/main.go @@ -0,0 +1,74 @@ +package main + +import ( + "fmt" + + "github.com/Peersyst/xrpl-go/pkg/crypto" + "github.com/Peersyst/xrpl-go/xrpl/faucet" + "github.com/Peersyst/xrpl-go/xrpl/queries/account" + "github.com/Peersyst/xrpl-go/xrpl/queries/common" + "github.com/Peersyst/xrpl-go/xrpl/queries/ledger" + "github.com/Peersyst/xrpl-go/xrpl/wallet" + "github.com/Peersyst/xrpl-go/xrpl/websocket" +) + +func main() { + + // Define the network client with a faucet provider + client := websocket.NewClient( + websocket.NewClientConfig(). + WithHost("wss://s.altnet.rippletest.net:51233"). + WithFaucetProvider(faucet.NewTestnetFaucetProvider()), + ) + + // Disconnect the client when done. (Defer executes at the end of the function) + defer client.Disconnect() + + // Connect to the network + if err := client.Connect(); err != nil { + fmt.Println(err) + return + } + + if !client.IsConnected() { + fmt.Println("❌ Failed to connect to testnet") + return + } + + fmt.Println("✅ Connected to testnet") + fmt.Println() + + // Create a new wallet + w, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Println(err) + return + } + fmt.Println("New wallet created:") + fmt.Println("Address:", w.ClassicAddress) + + // Fund the wallet with testnet XRP + if err := client.FundWallet(&w); err != nil { + fmt.Println(err) + return + } + + // Get info from the ledger about the address we just funded + acc_info, err := client.GetAccountInfo(&account.InfoRequest{ + Account: w.GetAddress(), + }) + if err != nil { + fmt.Println(err) + return + } + fmt.Println("Account Balance:", acc_info.AccountData.Balance) + fmt.Println("Account Sequence:", acc_info.AccountData.Sequence) + + // Get info about the ledger + ledger, err := client.GetLedger(&ledger.Request{LedgerIndex: common.Current}) + if err != nil { + fmt.Println(err) + return + } + fmt.Println("Ledger Index:", ledger.Ledger.LedgerIndex) +} diff --git a/_code-samples/get-started/go/go.mod b/_code-samples/get-started/go/go.mod new file mode 100644 index 0000000000..fa9fde5d08 --- /dev/null +++ b/_code-samples/get-started/go/go.mod @@ -0,0 +1,24 @@ +module github.com/XRPLF + +go 1.23.0 + +toolchain go1.23.10 + +require github.com/Peersyst/xrpl-go v0.1.11 + +require ( + github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e // indirect + github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec // indirect + github.com/btcsuite/btcd/btcec/v2 v2.3.4 // indirect + github.com/decred/dcrd/crypto/ripemd160 v1.0.2 // indirect + github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 // indirect + github.com/gorilla/websocket v1.5.0 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/mitchellh/mapstructure v1.5.0 // indirect + github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/tyler-smith/go-bip32 v1.0.0 // indirect + github.com/tyler-smith/go-bip39 v1.1.0 // indirect + github.com/ugorji/go/codec v1.2.11 // indirect + golang.org/x/crypto v0.23.0 // indirect +) diff --git a/_code-samples/get-started/go/go.sum b/_code-samples/get-started/go/go.sum new file mode 100644 index 0000000000..8d8522a619 --- /dev/null +++ b/_code-samples/get-started/go/go.sum @@ -0,0 +1,58 @@ +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e h1:ahyvB3q25YnZWly5Gq1ekg6jcmWaGj/vG/MhF4aisoc= +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:kGUqhHd//musdITWjFvNTHn90WG9bMLBEPQZ17Cmlpw= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec h1:1Qb69mGp/UtRPn422BH4/Y4Q3SLUrD9KHuDkm8iodFc= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec/go.mod h1:CD8UlnlLDiqb36L110uqiP2iSflVjx9g/3U9hCI4q2U= +github.com/Peersyst/xrpl-go v0.1.11 h1:P6r/gHxRnbAtAdPmzNHz/7zpsdfvwh0SS+QI2JNT44w= +github.com/Peersyst/xrpl-go v0.1.11/go.mod h1:CBRM3/soqNeeL2Jx6USVUtECqulZVUoq3UxZKMz9hdw= +github.com/btcsuite/btcd/btcec/v2 v2.3.4 h1:3EJjcN70HCu/mwqlUsGK8GcNVyLVxFDlWurTXGPFfiQ= +github.com/btcsuite/btcd/btcec/v2 v2.3.4/go.mod h1:zYzJ8etWJQIv1Ogk7OzpWjowwOdXY1W/17j2MW85J04= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e h1:0XBUw73chJ1VYSsfvcPvVT7auykAJce9FpRr10L6Qhw= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:P13beTBKr5Q18lJe1rIoLUqjM+CB1zYrRg44ZqGuQSA= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/decred/dcrd/crypto/blake256 v1.0.1 h1:7PltbUIQB7u/FfZ39+DGa/ShuMyJ5ilcvdfma9wOH6Y= +github.com/decred/dcrd/crypto/blake256 v1.0.1/go.mod h1:2OfgNZ5wDpcsFmHmCK5gZTPcCXqlm2ArzUIkw9czNJo= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2 h1:TvGTmUBHDU75OHro9ojPLK+Yv7gDl2hnUvRocRCjsys= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2/go.mod h1:uGfjDyePSpa75cSQLzNdVmWlbQMBuiJkvXw/MNKRY4M= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 h1:rpfIENRNNilwHwZeG5+P150SMrnNEcHYvcCuK6dPZSg= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0/go.mod h1:v57UDF4pDQJcEfFUCRop3lJL149eHGSe9Jvczhzjo/0= +github.com/golang/mock v1.6.0 h1:ErTB+efbowRARo13NNdxyJji2egdxLGQhRaY+DUumQc= +github.com/golang/mock v1.6.0/go.mod h1:p6yTPP+5HYm5mzsMV8JkE6ZKdX+/wYM6Hr+LicevLPs= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= +github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= +github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 h1:ZqeYNhU3OHLH3mGKHDcjJRFFRrJa6eAM5H+CtDdOsPc= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.1.5-0.20170601210322-f6abca593680/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/tyler-smith/go-bip32 v1.0.0 h1:sDR9juArbUgX+bO/iblgZnMPeWY1KZMUC2AFUJdv5KE= +github.com/tyler-smith/go-bip32 v1.0.0/go.mod h1:onot+eHknzV4BVPwrzqY5OoVpyCvnwD7lMawL5aQupE= +github.com/tyler-smith/go-bip39 v1.1.0 h1:5eUemwrMargf3BSLRRCalXT93Ns6pQJIjYQN2nyfOP8= +github.com/tyler-smith/go-bip39 v1.1.0/go.mod h1:gUYDtqQw1JS3ZJ8UWVcGTGqqr6YIN3CWg+kkNaLt55U= +github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU= +github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +golang.org/x/crypto v0.0.0-20170613210332-850760c427c5/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI= +golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087 h1:Izowp2XBH6Ya6rv+hqbceQyw/gSGoXfH/UPoTGduL54= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087/go.mod h1:hj7XX3B/0A+80Vse0e+BUHsHMTEhd0O4cpUHr/e/BUM= diff --git a/_code-samples/get-tx/go/go.mod b/_code-samples/get-tx/go/go.mod new file mode 100644 index 0000000000..2b62834f20 --- /dev/null +++ b/_code-samples/get-tx/go/go.mod @@ -0,0 +1,23 @@ +module github.com/XRPLF + +go 1.23.0 + +toolchain go1.23.10 + +require github.com/Peersyst/xrpl-go v0.1.11 + +require ( + github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e // indirect + github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec // indirect + github.com/btcsuite/btcd/btcec/v2 v2.3.4 // indirect + github.com/decred/dcrd/crypto/ripemd160 v1.0.2 // indirect + github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/mitchellh/mapstructure v1.5.0 // indirect + github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/tyler-smith/go-bip32 v1.0.0 // indirect + github.com/tyler-smith/go-bip39 v1.1.0 // indirect + github.com/ugorji/go/codec v1.2.11 // indirect + golang.org/x/crypto v0.23.0 // indirect +) diff --git a/_code-samples/get-tx/go/go.sum b/_code-samples/get-tx/go/go.sum new file mode 100644 index 0000000000..175bc12e7d --- /dev/null +++ b/_code-samples/get-tx/go/go.sum @@ -0,0 +1,56 @@ +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e h1:ahyvB3q25YnZWly5Gq1ekg6jcmWaGj/vG/MhF4aisoc= +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:kGUqhHd//musdITWjFvNTHn90WG9bMLBEPQZ17Cmlpw= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec h1:1Qb69mGp/UtRPn422BH4/Y4Q3SLUrD9KHuDkm8iodFc= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec/go.mod h1:CD8UlnlLDiqb36L110uqiP2iSflVjx9g/3U9hCI4q2U= +github.com/Peersyst/xrpl-go v0.1.11 h1:P6r/gHxRnbAtAdPmzNHz/7zpsdfvwh0SS+QI2JNT44w= +github.com/Peersyst/xrpl-go v0.1.11/go.mod h1:CBRM3/soqNeeL2Jx6USVUtECqulZVUoq3UxZKMz9hdw= +github.com/btcsuite/btcd/btcec/v2 v2.3.4 h1:3EJjcN70HCu/mwqlUsGK8GcNVyLVxFDlWurTXGPFfiQ= +github.com/btcsuite/btcd/btcec/v2 v2.3.4/go.mod h1:zYzJ8etWJQIv1Ogk7OzpWjowwOdXY1W/17j2MW85J04= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e h1:0XBUw73chJ1VYSsfvcPvVT7auykAJce9FpRr10L6Qhw= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:P13beTBKr5Q18lJe1rIoLUqjM+CB1zYrRg44ZqGuQSA= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/decred/dcrd/crypto/blake256 v1.0.1 h1:7PltbUIQB7u/FfZ39+DGa/ShuMyJ5ilcvdfma9wOH6Y= +github.com/decred/dcrd/crypto/blake256 v1.0.1/go.mod h1:2OfgNZ5wDpcsFmHmCK5gZTPcCXqlm2ArzUIkw9czNJo= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2 h1:TvGTmUBHDU75OHro9ojPLK+Yv7gDl2hnUvRocRCjsys= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2/go.mod h1:uGfjDyePSpa75cSQLzNdVmWlbQMBuiJkvXw/MNKRY4M= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 h1:rpfIENRNNilwHwZeG5+P150SMrnNEcHYvcCuK6dPZSg= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0/go.mod h1:v57UDF4pDQJcEfFUCRop3lJL149eHGSe9Jvczhzjo/0= +github.com/golang/mock v1.6.0 h1:ErTB+efbowRARo13NNdxyJji2egdxLGQhRaY+DUumQc= +github.com/golang/mock v1.6.0/go.mod h1:p6yTPP+5HYm5mzsMV8JkE6ZKdX+/wYM6Hr+LicevLPs= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= +github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 h1:ZqeYNhU3OHLH3mGKHDcjJRFFRrJa6eAM5H+CtDdOsPc= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.1.5-0.20170601210322-f6abca593680/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/tyler-smith/go-bip32 v1.0.0 h1:sDR9juArbUgX+bO/iblgZnMPeWY1KZMUC2AFUJdv5KE= +github.com/tyler-smith/go-bip32 v1.0.0/go.mod h1:onot+eHknzV4BVPwrzqY5OoVpyCvnwD7lMawL5aQupE= +github.com/tyler-smith/go-bip39 v1.1.0 h1:5eUemwrMargf3BSLRRCalXT93Ns6pQJIjYQN2nyfOP8= +github.com/tyler-smith/go-bip39 v1.1.0/go.mod h1:gUYDtqQw1JS3ZJ8UWVcGTGqqr6YIN3CWg+kkNaLt55U= +github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU= +github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +golang.org/x/crypto v0.0.0-20170613210332-850760c427c5/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI= +golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087 h1:Izowp2XBH6Ya6rv+hqbceQyw/gSGoXfH/UPoTGduL54= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087/go.mod h1:hj7XX3B/0A+80Vse0e+BUHsHMTEhd0O4cpUHr/e/BUM= diff --git a/_code-samples/get-tx/go/main.go b/_code-samples/get-tx/go/main.go new file mode 100644 index 0000000000..d7d2f4ae26 --- /dev/null +++ b/_code-samples/get-tx/go/main.go @@ -0,0 +1,45 @@ +package main + +import ( + "fmt" + + "github.com/Peersyst/xrpl-go/xrpl/queries/common" + "github.com/Peersyst/xrpl-go/xrpl/queries/ledger" + "github.com/Peersyst/xrpl-go/xrpl/queries/transactions" + "github.com/Peersyst/xrpl-go/xrpl/rpc" +) + +func main() { + cfg, err := rpc.NewClientConfig( + "https://s.altnet.rippletest.net:51234/", + ) + if err != nil { + panic(err) + } + + client := rpc.NewClient(cfg) + + led, err := client.GetLedger(&ledger.Request{ + Transactions: true, + LedgerIndex: common.Validated, + }) + if err != nil { + panic(err) + } + fmt.Println("Latest validated ledger:", led) + + // Get the first transaction hash from the ledger + if len(led.Ledger.Transactions) > 0 { + txHash := led.Ledger.Transactions[0].(string) // type assertion may be needed + + // Query the transaction details + txResp, err := client.Request(&transactions.TxRequest{ + Transaction: txHash, + }) + if err != nil { + panic(err) + } + fmt.Println("First transaction in the ledger:") + fmt.Println(txResp) + } +} diff --git a/_code-samples/issue-a-token/go/go.mod b/_code-samples/issue-a-token/go/go.mod new file mode 100644 index 0000000000..fa9fde5d08 --- /dev/null +++ b/_code-samples/issue-a-token/go/go.mod @@ -0,0 +1,24 @@ +module github.com/XRPLF + +go 1.23.0 + +toolchain go1.23.10 + +require github.com/Peersyst/xrpl-go v0.1.11 + +require ( + github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e // indirect + github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec // indirect + github.com/btcsuite/btcd/btcec/v2 v2.3.4 // indirect + github.com/decred/dcrd/crypto/ripemd160 v1.0.2 // indirect + github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 // indirect + github.com/gorilla/websocket v1.5.0 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/mitchellh/mapstructure v1.5.0 // indirect + github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/tyler-smith/go-bip32 v1.0.0 // indirect + github.com/tyler-smith/go-bip39 v1.1.0 // indirect + github.com/ugorji/go/codec v1.2.11 // indirect + golang.org/x/crypto v0.23.0 // indirect +) diff --git a/_code-samples/issue-a-token/go/go.sum b/_code-samples/issue-a-token/go/go.sum new file mode 100644 index 0000000000..8d8522a619 --- /dev/null +++ b/_code-samples/issue-a-token/go/go.sum @@ -0,0 +1,58 @@ +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e h1:ahyvB3q25YnZWly5Gq1ekg6jcmWaGj/vG/MhF4aisoc= +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:kGUqhHd//musdITWjFvNTHn90WG9bMLBEPQZ17Cmlpw= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec h1:1Qb69mGp/UtRPn422BH4/Y4Q3SLUrD9KHuDkm8iodFc= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec/go.mod h1:CD8UlnlLDiqb36L110uqiP2iSflVjx9g/3U9hCI4q2U= +github.com/Peersyst/xrpl-go v0.1.11 h1:P6r/gHxRnbAtAdPmzNHz/7zpsdfvwh0SS+QI2JNT44w= +github.com/Peersyst/xrpl-go v0.1.11/go.mod h1:CBRM3/soqNeeL2Jx6USVUtECqulZVUoq3UxZKMz9hdw= +github.com/btcsuite/btcd/btcec/v2 v2.3.4 h1:3EJjcN70HCu/mwqlUsGK8GcNVyLVxFDlWurTXGPFfiQ= +github.com/btcsuite/btcd/btcec/v2 v2.3.4/go.mod h1:zYzJ8etWJQIv1Ogk7OzpWjowwOdXY1W/17j2MW85J04= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e h1:0XBUw73chJ1VYSsfvcPvVT7auykAJce9FpRr10L6Qhw= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:P13beTBKr5Q18lJe1rIoLUqjM+CB1zYrRg44ZqGuQSA= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/decred/dcrd/crypto/blake256 v1.0.1 h1:7PltbUIQB7u/FfZ39+DGa/ShuMyJ5ilcvdfma9wOH6Y= +github.com/decred/dcrd/crypto/blake256 v1.0.1/go.mod h1:2OfgNZ5wDpcsFmHmCK5gZTPcCXqlm2ArzUIkw9czNJo= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2 h1:TvGTmUBHDU75OHro9ojPLK+Yv7gDl2hnUvRocRCjsys= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2/go.mod h1:uGfjDyePSpa75cSQLzNdVmWlbQMBuiJkvXw/MNKRY4M= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 h1:rpfIENRNNilwHwZeG5+P150SMrnNEcHYvcCuK6dPZSg= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0/go.mod h1:v57UDF4pDQJcEfFUCRop3lJL149eHGSe9Jvczhzjo/0= +github.com/golang/mock v1.6.0 h1:ErTB+efbowRARo13NNdxyJji2egdxLGQhRaY+DUumQc= +github.com/golang/mock v1.6.0/go.mod h1:p6yTPP+5HYm5mzsMV8JkE6ZKdX+/wYM6Hr+LicevLPs= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= +github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= +github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 h1:ZqeYNhU3OHLH3mGKHDcjJRFFRrJa6eAM5H+CtDdOsPc= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.1.5-0.20170601210322-f6abca593680/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/tyler-smith/go-bip32 v1.0.0 h1:sDR9juArbUgX+bO/iblgZnMPeWY1KZMUC2AFUJdv5KE= +github.com/tyler-smith/go-bip32 v1.0.0/go.mod h1:onot+eHknzV4BVPwrzqY5OoVpyCvnwD7lMawL5aQupE= +github.com/tyler-smith/go-bip39 v1.1.0 h1:5eUemwrMargf3BSLRRCalXT93Ns6pQJIjYQN2nyfOP8= +github.com/tyler-smith/go-bip39 v1.1.0/go.mod h1:gUYDtqQw1JS3ZJ8UWVcGTGqqr6YIN3CWg+kkNaLt55U= +github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU= +github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +golang.org/x/crypto v0.0.0-20170613210332-850760c427c5/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI= +golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087 h1:Izowp2XBH6Ya6rv+hqbceQyw/gSGoXfH/UPoTGduL54= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087/go.mod h1:hj7XX3B/0A+80Vse0e+BUHsHMTEhd0O4cpUHr/e/BUM= diff --git a/_code-samples/issue-a-token/go/rpc/main.go b/_code-samples/issue-a-token/go/rpc/main.go new file mode 100644 index 0000000000..bbdec424c7 --- /dev/null +++ b/_code-samples/issue-a-token/go/rpc/main.go @@ -0,0 +1,523 @@ +package main + +import ( + "fmt" + + "github.com/Peersyst/xrpl-go/pkg/crypto" + "github.com/Peersyst/xrpl-go/xrpl/faucet" + "github.com/Peersyst/xrpl-go/xrpl/rpc" + transactions "github.com/Peersyst/xrpl-go/xrpl/transaction" + "github.com/Peersyst/xrpl-go/xrpl/transaction/types" + "github.com/Peersyst/xrpl-go/xrpl/wallet" +) + +const ( + currencyCode = "FOO" +) + +func main() { + // + // Configure client + // + fmt.Println("⏳ Setting up client...") + cfg, err := rpc.NewClientConfig( + "https://s.altnet.rippletest.net:51234/", + rpc.WithFaucetProvider(faucet.NewTestnetFaucetProvider()), + ) + if err != nil { + panic(err) + } + + client := rpc.NewClient(cfg) + fmt.Println("✅ Client configured!") + fmt.Println() + + // + // Configure wallets + // + fmt.Println("⏳ Setting up wallets...") + coldWallet, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Printf("❌ Error creating cold wallet: %s\n", err) + return + } + err = client.FundWallet(&coldWallet) + if err != nil { + fmt.Printf("❌ Error funding cold wallet: %s\n", err) + return + } + fmt.Println("💸 Cold wallet funded!") + + hotWallet, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Printf("❌ Error creating hot wallet: %s\n", err) + return + } + err = client.FundWallet(&hotWallet) + if err != nil { + fmt.Printf("❌ Error funding hot wallet: %s\n", err) + return + } + fmt.Println("💸 Hot wallet funded!") + + customerOneWallet, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Printf("❌ Error creating token wallet: %s\n", err) + return + } + err = client.FundWallet(&customerOneWallet) + if err != nil { + fmt.Printf("❌ Error funding customer one wallet: %s\n", err) + return + } + fmt.Println("💸 Customer one wallet funded!") + fmt.Println() + + fmt.Println("✅ Wallets setup complete!") + fmt.Println("💳 Cold wallet:", coldWallet.ClassicAddress) + fmt.Println("💳 Hot wallet:", hotWallet.ClassicAddress) + fmt.Println("💳 Customer one wallet:", customerOneWallet.ClassicAddress) + fmt.Println() + + // + // Configure cold address settings + // + fmt.Println("⏳ Configuring cold address settings...") + coldWalletAccountSet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + TickSize: types.TickSize(5), + TransferRate: types.TransferRate(0), + Domain: types.Domain("6578616D706C652E636F6D"), // example.com + } + + coldWalletAccountSet.SetAsfDefaultRipple() + coldWalletAccountSet.SetDisallowXRP() + + coldWalletAccountSet.SetRequireDestTag() + + flattenedTx := coldWalletAccountSet.Flatten() + + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err := coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err := client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Cold address settings configuration failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Cold address settings configured!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Configure hot address settings + // + fmt.Println("⏳ Configuring hot address settings...") + hotWalletAccountSet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + Domain: types.Domain("6578616D706C652E636F6D"), // example.com + } + + hotWalletAccountSet.SetAsfRequireAuth() + hotWalletAccountSet.SetDisallowXRP() + hotWalletAccountSet.SetRequireDestTag() + + flattenedTx = hotWalletAccountSet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Hot address settings configuration failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Hot address settings configured!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Create trust line from hot to cold address + // + fmt.Println("⏳ Creating trust line from hot to cold address...") + hotColdTrustSet := &transactions.TrustSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + LimitAmount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100000000000000", + }, + } + + flattenedTx = hotColdTrustSet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Trust line from hot to cold address creation failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Trust line from hot to cold address created!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Create trust line from costumer one to cold address + // + fmt.Println("⏳ Creating trust line from customer one to cold address...") + customerOneColdTrustSet := &transactions.TrustSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(customerOneWallet.ClassicAddress), + }, + LimitAmount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100000000000000", + }, + } + + flattenedTx = customerOneColdTrustSet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = customerOneWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Trust line from customer one to cold address creation failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Trust line from customer one to cold address created!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Send tokens from cold wallet to hot wallet + // + fmt.Println("⏳ Sending tokens from cold wallet to hot wallet...") + coldToHotPayment := &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "3800", + }, + Destination: types.Address(hotWallet.ClassicAddress), + DestinationTag: types.DestinationTag(1), + } + + flattenedTx = coldToHotPayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Tokens not sent from cold wallet to hot wallet!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Tokens sent from cold wallet to hot wallet!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Send tokens from hot wallet to customer one + // + fmt.Println("⏳ Sending tokens from cold wallet to customer one...") + coldToCustomerOnePayment := &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100", + }, + Destination: types.Address(customerOneWallet.ClassicAddress), + } + + flattenedTx = coldToCustomerOnePayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Tokens not sent from cold wallet to customer one!") + fmt.Println() + return + } + + fmt.Println("✅ Tokens sent from cold wallet to customer one!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Freeze cold wallet + // + fmt.Println("⏳ Freezing cold wallet...") + freezeColdWallet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + } + + freezeColdWallet.SetAsfGlobalFreeze() + + flattenedTx = freezeColdWallet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Cold wallet freezing failed!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + return + } + + fmt.Println("✅ Cold wallet frozen!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Try to send tokens from hot wallet to customer one + // + fmt.Println("⏳ Trying to send tokens from hot wallet to customer one...") + hotToCustomerOnePayment := &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100", + }, + Destination: types.Address(customerOneWallet.ClassicAddress), + } + + flattenedTx = hotToCustomerOnePayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + _, err = client.SubmitTxBlobAndWait(txBlob, false) + if err == nil { + return + } + + fmt.Println("❌ Tokens not sent from hot wallet to customer one!") + fmt.Println() + + // // + // // Unfreeze cold wallet + // // + fmt.Println("⏳ Unfreezing cold wallet...") + unfreezeColdWallet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + } + + unfreezeColdWallet.ClearAsfGlobalFreeze() + + flattenedTx = unfreezeColdWallet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Cold wallet unfreezing failed!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + return + } + + fmt.Println("✅ Cold wallet unfrozen!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Try to send tokens from hot wallet to customer one + // + fmt.Println("⏳ Trying to send tokens from hot wallet to customer one...") + hotToCustomerOnePayment = &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100", + }, + Destination: types.Address(customerOneWallet.ClassicAddress), + } + + flattenedTx = hotToCustomerOnePayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Tokens not sent from hot wallet to customer one!") + fmt.Println("Try again!") + return + } + + fmt.Println("✅ Tokens sent from hot wallet to customer one!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() +} diff --git a/_code-samples/issue-a-token/go/ws/main.go b/_code-samples/issue-a-token/go/ws/main.go new file mode 100644 index 0000000000..04a57383dd --- /dev/null +++ b/_code-samples/issue-a-token/go/ws/main.go @@ -0,0 +1,529 @@ +package main + +import ( + "fmt" + + "github.com/Peersyst/xrpl-go/pkg/crypto" + "github.com/Peersyst/xrpl-go/xrpl/faucet" + transactions "github.com/Peersyst/xrpl-go/xrpl/transaction" + "github.com/Peersyst/xrpl-go/xrpl/transaction/types" + "github.com/Peersyst/xrpl-go/xrpl/wallet" + "github.com/Peersyst/xrpl-go/xrpl/websocket" +) + +const ( + currencyCode = "FOO" +) + +func main() { + // + // Configure client + // + fmt.Println("⏳ Setting up client...") + client := websocket.NewClient( + websocket.NewClientConfig(). + WithHost("wss://s.altnet.rippletest.net"). + WithFaucetProvider(faucet.NewTestnetFaucetProvider()), + ) + defer client.Disconnect() + fmt.Println("✅ Client configured!") + fmt.Println() + + fmt.Println("Connecting to server...") + if err := client.Connect(); err != nil { + fmt.Println(err) + return + } + + fmt.Println("Connection: ", client.IsConnected()) + fmt.Println() + + // + // Configure wallets + // + fmt.Println("⏳ Setting up wallets...") + coldWallet, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Printf("❌ Error creating cold wallet: %s\n", err) + return + } + err = client.FundWallet(&coldWallet) + if err != nil { + fmt.Printf("❌ Error funding cold wallet: %s\n", err) + return + } + fmt.Println("💸 Cold wallet funded!") + + hotWallet, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Printf("❌ Error creating hot wallet: %s\n", err) + return + } + err = client.FundWallet(&hotWallet) + if err != nil { + fmt.Printf("❌ Error funding hot wallet: %s\n", err) + return + } + fmt.Println("💸 Hot wallet funded!") + + customerOneWallet, err := wallet.New(crypto.ED25519()) + if err != nil { + fmt.Printf("❌ Error creating token wallet: %s\n", err) + return + } + err = client.FundWallet(&customerOneWallet) + if err != nil { + fmt.Printf("❌ Error funding customer one wallet: %s\n", err) + return + } + fmt.Println("💸 Customer one wallet funded!") + fmt.Println() + + fmt.Println("✅ Wallets setup complete!") + fmt.Println("💳 Cold wallet:", coldWallet.ClassicAddress) + fmt.Println("💳 Hot wallet:", hotWallet.ClassicAddress) + fmt.Println("💳 Customer one wallet:", customerOneWallet.ClassicAddress) + fmt.Println() + + // + // Configure cold address settings + // + fmt.Println("⏳ Configuring cold address settings...") + coldWalletAccountSet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + TickSize: types.TickSize(5), + TransferRate: types.TransferRate(0), + Domain: types.Domain("6578616D706C652E636F6D"), // example.com + } + + coldWalletAccountSet.SetAsfDefaultRipple() + coldWalletAccountSet.SetDisallowXRP() + + coldWalletAccountSet.SetRequireDestTag() + + flattenedTx := coldWalletAccountSet.Flatten() + + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err := coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err := client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Cold address settings configuration failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Cold address settings configured!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Configure hot address settings + // + fmt.Println("⏳ Configuring hot address settings...") + hotWalletAccountSet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + Domain: types.Domain("6578616D706C652E636F6D"), // example.com + } + + hotWalletAccountSet.SetAsfRequireAuth() + hotWalletAccountSet.SetDisallowXRP() + hotWalletAccountSet.SetRequireDestTag() + + flattenedTx = hotWalletAccountSet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Hot address settings configuration failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Hot address settings configured!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Create trust line from hot to cold address + // + fmt.Println("⏳ Creating trust line from hot to cold address...") + hotColdTrustSet := &transactions.TrustSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + LimitAmount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100000000000000", + }, + } + + flattenedTx = hotColdTrustSet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Trust line from hot to cold address creation failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Trust line from hot to cold address created!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Create trust line from costumer one to cold address + // + fmt.Println("⏳ Creating trust line from customer one to cold address...") + customerOneColdTrustSet := &transactions.TrustSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(customerOneWallet.ClassicAddress), + }, + LimitAmount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100000000000000", + }, + } + + flattenedTx = customerOneColdTrustSet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = customerOneWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Trust line from customer one to cold address creation failed!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Trust line from customer one to cold address created!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Send tokens from cold wallet to hot wallet + // + fmt.Println("⏳ Sending tokens from cold wallet to hot wallet...") + coldToHotPayment := &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "3800", + }, + Destination: types.Address(hotWallet.ClassicAddress), + DestinationTag: types.DestinationTag(1), + } + + flattenedTx = coldToHotPayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Tokens not sent from cold wallet to hot wallet!") + fmt.Println("Try again!") + fmt.Println() + return + } + + fmt.Println("✅ Tokens sent from cold wallet to hot wallet!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Send tokens from hot wallet to customer one + // + fmt.Println("⏳ Sending tokens from cold wallet to customer one...") + coldToCustomerOnePayment := &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100", + }, + Destination: types.Address(customerOneWallet.ClassicAddress), + } + + flattenedTx = coldToCustomerOnePayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Tokens not sent from cold wallet to customer one!") + fmt.Println() + return + } + + fmt.Println("✅ Tokens sent from cold wallet to customer one!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Freeze cold wallet + // + fmt.Println("⏳ Freezing cold wallet...") + freezeColdWallet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + } + + freezeColdWallet.SetAsfGlobalFreeze() + + flattenedTx = freezeColdWallet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Cold wallet freezing failed!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + return + } + + fmt.Println("✅ Cold wallet frozen!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Try to send tokens from hot wallet to customer one + // + fmt.Println("⏳ Trying to send tokens from hot wallet to customer one...") + hotToCustomerOnePayment := &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100", + }, + Destination: types.Address(customerOneWallet.ClassicAddress), + } + + flattenedTx = hotToCustomerOnePayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + _, err = client.SubmitTxBlobAndWait(txBlob, false) + if err == nil { + return + } + + fmt.Println("❌ Tokens not sent from hot wallet to customer one!") + fmt.Println() + + // // + // // Unfreeze cold wallet + // // + fmt.Println("⏳ Unfreezing cold wallet...") + unfreezeColdWallet := &transactions.AccountSet{ + BaseTx: transactions.BaseTx{ + Account: types.Address(coldWallet.ClassicAddress), + }, + } + + unfreezeColdWallet.ClearAsfGlobalFreeze() + + flattenedTx = unfreezeColdWallet.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = coldWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Cold wallet unfreezing failed!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + return + } + + fmt.Println("✅ Cold wallet unfrozen!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() + + // + // Try to send tokens from hot wallet to customer one + // + fmt.Println("⏳ Trying to send tokens from hot wallet to customer one...") + hotToCustomerOnePayment = &transactions.Payment{ + BaseTx: transactions.BaseTx{ + Account: types.Address(hotWallet.ClassicAddress), + }, + Amount: types.IssuedCurrencyAmount{ + Currency: currencyCode, + Issuer: types.Address(coldWallet.ClassicAddress), + Value: "100", + }, + Destination: types.Address(customerOneWallet.ClassicAddress), + } + + flattenedTx = hotToCustomerOnePayment.Flatten() + err = client.Autofill(&flattenedTx) + if err != nil { + fmt.Printf("❌ Error autofilling transaction: %s\n", err) + return + } + + txBlob, _, err = hotWallet.Sign(flattenedTx) + if err != nil { + fmt.Printf("❌ Error signing transaction: %s\n", err) + return + } + + response, err = client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Printf("❌ Error submitting transaction: %s\n", err) + return + } + + if !response.Validated { + fmt.Println("❌ Tokens not sent from hot wallet to customer one!") + fmt.Println("Try again!") + return + } + + fmt.Println("✅ Tokens sent from hot wallet to customer one!") + fmt.Printf("🌐 Hash: %s\n", response.Hash.String()) + fmt.Println() +} diff --git a/_code-samples/send-xrp/go/go.mod b/_code-samples/send-xrp/go/go.mod index 63f569b0cd..fa9fde5d08 100644 --- a/_code-samples/send-xrp/go/go.mod +++ b/_code-samples/send-xrp/go/go.mod @@ -1,5 +1,24 @@ module github.com/XRPLF -go 1.23 +go 1.23.0 -require github.com/Peersyst/xrpl-go v0.1.11 \ No newline at end of file +toolchain go1.23.10 + +require github.com/Peersyst/xrpl-go v0.1.11 + +require ( + github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e // indirect + github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec // indirect + github.com/btcsuite/btcd/btcec/v2 v2.3.4 // indirect + github.com/decred/dcrd/crypto/ripemd160 v1.0.2 // indirect + github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 // indirect + github.com/gorilla/websocket v1.5.0 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/mitchellh/mapstructure v1.5.0 // indirect + github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/tyler-smith/go-bip32 v1.0.0 // indirect + github.com/tyler-smith/go-bip39 v1.1.0 // indirect + github.com/ugorji/go/codec v1.2.11 // indirect + golang.org/x/crypto v0.23.0 // indirect +) diff --git a/_code-samples/send-xrp/go/go.sum b/_code-samples/send-xrp/go/go.sum new file mode 100644 index 0000000000..8d8522a619 --- /dev/null +++ b/_code-samples/send-xrp/go/go.sum @@ -0,0 +1,58 @@ +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e h1:ahyvB3q25YnZWly5Gq1ekg6jcmWaGj/vG/MhF4aisoc= +github.com/FactomProject/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:kGUqhHd//musdITWjFvNTHn90WG9bMLBEPQZ17Cmlpw= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec h1:1Qb69mGp/UtRPn422BH4/Y4Q3SLUrD9KHuDkm8iodFc= +github.com/FactomProject/btcutilecc v0.0.0-20130527213604-d3a63a5752ec/go.mod h1:CD8UlnlLDiqb36L110uqiP2iSflVjx9g/3U9hCI4q2U= +github.com/Peersyst/xrpl-go v0.1.11 h1:P6r/gHxRnbAtAdPmzNHz/7zpsdfvwh0SS+QI2JNT44w= +github.com/Peersyst/xrpl-go v0.1.11/go.mod h1:CBRM3/soqNeeL2Jx6USVUtECqulZVUoq3UxZKMz9hdw= +github.com/btcsuite/btcd/btcec/v2 v2.3.4 h1:3EJjcN70HCu/mwqlUsGK8GcNVyLVxFDlWurTXGPFfiQ= +github.com/btcsuite/btcd/btcec/v2 v2.3.4/go.mod h1:zYzJ8etWJQIv1Ogk7OzpWjowwOdXY1W/17j2MW85J04= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e h1:0XBUw73chJ1VYSsfvcPvVT7auykAJce9FpRr10L6Qhw= +github.com/cmars/basen v0.0.0-20150613233007-fe3947df716e/go.mod h1:P13beTBKr5Q18lJe1rIoLUqjM+CB1zYrRg44ZqGuQSA= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/decred/dcrd/crypto/blake256 v1.0.1 h1:7PltbUIQB7u/FfZ39+DGa/ShuMyJ5ilcvdfma9wOH6Y= +github.com/decred/dcrd/crypto/blake256 v1.0.1/go.mod h1:2OfgNZ5wDpcsFmHmCK5gZTPcCXqlm2ArzUIkw9czNJo= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2 h1:TvGTmUBHDU75OHro9ojPLK+Yv7gDl2hnUvRocRCjsys= +github.com/decred/dcrd/crypto/ripemd160 v1.0.2/go.mod h1:uGfjDyePSpa75cSQLzNdVmWlbQMBuiJkvXw/MNKRY4M= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 h1:rpfIENRNNilwHwZeG5+P150SMrnNEcHYvcCuK6dPZSg= +github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0/go.mod h1:v57UDF4pDQJcEfFUCRop3lJL149eHGSe9Jvczhzjo/0= +github.com/golang/mock v1.6.0 h1:ErTB+efbowRARo13NNdxyJji2egdxLGQhRaY+DUumQc= +github.com/golang/mock v1.6.0/go.mod h1:p6yTPP+5HYm5mzsMV8JkE6ZKdX+/wYM6Hr+LicevLPs= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= +github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= +github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 h1:ZqeYNhU3OHLH3mGKHDcjJRFFRrJa6eAM5H+CtDdOsPc= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.1.5-0.20170601210322-f6abca593680/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/tyler-smith/go-bip32 v1.0.0 h1:sDR9juArbUgX+bO/iblgZnMPeWY1KZMUC2AFUJdv5KE= +github.com/tyler-smith/go-bip32 v1.0.0/go.mod h1:onot+eHknzV4BVPwrzqY5OoVpyCvnwD7lMawL5aQupE= +github.com/tyler-smith/go-bip39 v1.1.0 h1:5eUemwrMargf3BSLRRCalXT93Ns6pQJIjYQN2nyfOP8= +github.com/tyler-smith/go-bip39 v1.1.0/go.mod h1:gUYDtqQw1JS3ZJ8UWVcGTGqqr6YIN3CWg+kkNaLt55U= +github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU= +github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +golang.org/x/crypto v0.0.0-20170613210332-850760c427c5/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI= +golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087 h1:Izowp2XBH6Ya6rv+hqbceQyw/gSGoXfH/UPoTGduL54= +launchpad.net/gocheck v0.0.0-20140225173054-000000000087/go.mod h1:hj7XX3B/0A+80Vse0e+BUHsHMTEhd0O4cpUHr/e/BUM= diff --git a/_code-samples/send-xrp/go/rpc/main.go b/_code-samples/send-xrp/go/rpc/main.go index 9ab1e3e8e7..fd62e66556 100644 --- a/_code-samples/send-xrp/go/rpc/main.go +++ b/_code-samples/send-xrp/go/rpc/main.go @@ -1 +1,111 @@ -package rpc +package main + +import ( + "fmt" + "strconv" + + "github.com/Peersyst/xrpl-go/xrpl/currency" + "github.com/Peersyst/xrpl-go/xrpl/faucet" + "github.com/Peersyst/xrpl-go/xrpl/rpc" + "github.com/Peersyst/xrpl-go/xrpl/transaction" + "github.com/Peersyst/xrpl-go/xrpl/transaction/types" + "github.com/Peersyst/xrpl-go/xrpl/wallet" + + rpctypes "github.com/Peersyst/xrpl-go/xrpl/rpc/types" +) + +const ( + WalletSeed = "sn3nxiW7v8KXzPzAqzyHXbSSKNuN9" +) + +func main() { + + cfg, err := rpc.NewClientConfig( + "https://s.altnet.rippletest.net:51234/", + rpc.WithMaxFeeXRP(5.0), + rpc.WithFeeCushion(1.5), + rpc.WithFaucetProvider(faucet.NewTestnetFaucetProvider()), + ) + if err != nil { + panic(err) + } + + client := rpc.NewClient(cfg) + + w, err := wallet.FromSeed(WalletSeed, "") + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("⏳ Funding wallet...") + if err := client.FundWallet(&w); err != nil { + fmt.Println(err) + return + } + + fmt.Println("💸 Wallet funded") + fmt.Println() + + xrpAmount, err := currency.XrpToDrops("1") + if err != nil { + fmt.Println(err) + return + } + + xrpAmountInt, err := strconv.ParseInt(xrpAmount, 10, 64) + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("⏳ Sending 1 XRP to rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe...") + p := &transaction.Payment{ + BaseTx: transaction.BaseTx{ + Account: types.Address(w.GetAddress()), + }, + Destination: "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe", + Amount: types.XRPCurrencyAmount(xrpAmountInt), + DeliverMax: types.XRPCurrencyAmount(xrpAmountInt), + } + + flattenedTx := p.Flatten() + + if err := client.Autofill(&flattenedTx); err != nil { + fmt.Println(err) + return + } + + txBlob, _, err := w.Sign(flattenedTx) + if err != nil { + fmt.Println(err) + return + } + + res, err := client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("✅ Payment submitted") + fmt.Printf("🌐 Hash: %s\n", res.Hash) + fmt.Printf("🌐 Validated: %t\n", res.Validated) + fmt.Println() + fmt.Println("⏳ Using SubmitTxAndWait with wallet") + fmt.Println() + + flattenedTx2 := p.Flatten() + resp, err := client.SubmitTxAndWait(flattenedTx2, &rpctypes.SubmitOptions{ + Autofill: true, + Wallet: &w, + }) + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("✅ Payment submitted via SubmitTxAndWait") + fmt.Printf("🌐 Hash: %s\n", resp.Hash) + fmt.Printf("🌐 Validated: %t\n", resp.Validated) +} diff --git a/_code-samples/send-xrp/go/ws/main.go b/_code-samples/send-xrp/go/ws/main.go index 98592950df..5f1e392ec6 100644 --- a/_code-samples/send-xrp/go/ws/main.go +++ b/_code-samples/send-xrp/go/ws/main.go @@ -1 +1,120 @@ -package ws +package main + +import ( + "fmt" + "strconv" + + "github.com/Peersyst/xrpl-go/xrpl/currency" + "github.com/Peersyst/xrpl-go/xrpl/faucet" + "github.com/Peersyst/xrpl-go/xrpl/transaction" + "github.com/Peersyst/xrpl-go/xrpl/transaction/types" + "github.com/Peersyst/xrpl-go/xrpl/wallet" + "github.com/Peersyst/xrpl-go/xrpl/websocket" + wstypes "github.com/Peersyst/xrpl-go/xrpl/websocket/types" +) + +const ( + WalletSeed = "sn3nxiW7v8KXzPzAqzyHXbSSKNuN9" +) + +func main() { + + fmt.Println("⏳ Connecting to testnet...") + client := websocket.NewClient( + websocket.NewClientConfig(). + WithHost("wss://s.altnet.rippletest.net:51233"). + WithFaucetProvider(faucet.NewTestnetFaucetProvider()), + ) + defer client.Disconnect() + + if err := client.Connect(); err != nil { + fmt.Println(err) + return + } + + if !client.IsConnected() { + fmt.Println("❌ Failed to connect to testnet") + return + } + + fmt.Println("✅ Connected to testnet") + fmt.Println() + + w, err := wallet.FromSeed(WalletSeed, "") + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("⏳ Funding wallet...") + if err := client.FundWallet(&w); err != nil { + fmt.Println(err) + return + } + + fmt.Println("💸 Wallet funded") + fmt.Println() + + xrpAmount, err := currency.XrpToDrops("1") + if err != nil { + fmt.Println(err) + return + } + + xrpAmountInt, err := strconv.ParseInt(xrpAmount, 10, 64) + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("⏳ Sending 1 XRP to rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe...") + p := &transaction.Payment{ + BaseTx: transaction.BaseTx{ + Account: types.Address(w.GetAddress()), + }, + Destination: "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe", + Amount: types.XRPCurrencyAmount(xrpAmountInt), + DeliverMax: types.XRPCurrencyAmount(xrpAmountInt), + } + + flattenedTx := p.Flatten() + + if err := client.Autofill(&flattenedTx); err != nil { + fmt.Println(err) + return + } + + txBlob, _, err := w.Sign(flattenedTx) + if err != nil { + fmt.Println(err) + return + } + + res, err := client.SubmitTxBlobAndWait(txBlob, false) + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("✅ Payment submitted") + fmt.Printf("🌐 Hash: %s\n", res.Hash) + fmt.Printf("🌐 Validated: %t\n", res.Validated) + + fmt.Println() + fmt.Println("⏳ Using SubmitTxAndWait with wallet") + fmt.Println() + + flattenedTx2 := p.Flatten() + resp, err := client.SubmitTxAndWait(flattenedTx2, &wstypes.SubmitOptions{ + Autofill: true, + Wallet: &w, + }) + if err != nil { + fmt.Println(err) + return + } + + fmt.Println("✅ Payment submitted via SubmitTxAndWait") + fmt.Printf("🌐 Hash: %s\n", resp.Hash) + fmt.Printf("🌐 Validated: %t\n", resp.Validated) +} diff --git a/_code-samples/use-tickets/go/rpc/main.go b/_code-samples/use-tickets/go/rpc/main.go index 1c48d20df8..626e8932d9 100644 --- a/_code-samples/use-tickets/go/rpc/main.go +++ b/_code-samples/use-tickets/go/rpc/main.go @@ -4,6 +4,7 @@ import ( "encoding/json" "fmt" + "github.com/Peersyst/xrpl-go/pkg/crypto" "github.com/Peersyst/xrpl-go/xrpl/faucet" "github.com/Peersyst/xrpl-go/xrpl/queries/account" "github.com/Peersyst/xrpl-go/xrpl/rpc" @@ -11,10 +12,6 @@ import ( "github.com/Peersyst/xrpl-go/xrpl/wallet" ) -const ( - WalletSeed = "sn3nxiW7v8KXzPzAqzyHXbSSKNuN9" -) - func main() { cfg, err := rpc.NewClientConfig( "https://s.altnet.rippletest.net:51234/", @@ -26,7 +23,7 @@ func main() { client := rpc.NewClient(cfg) - w, err := wallet.FromSeed(WalletSeed, "") + w, err := wallet.New(crypto.ED25519()) if err != nil { fmt.Println(err) return