Add xrpl-go examples and references to xrpl-dev-portal #3211

banasa44 · 2025-07-23T08:53:04Z

Add xrpl-go examples and references to xrpl-dev-portal

Description

This PR aims to include the xrpl-go library into the XRPLF xrpl-dev-portal repository. Including code samples, and references to it in the documentation site.

Changes

Add code samples.
Add link in the nav-bar
Add card in Tutorials section
Add GoLang Docs in Tutorial section (Build apps - get started)
Add GoLang in send-xrp How to's
Add GoLang in References, and in Client Libraries

Notes

Notice that all the references to xrpl-go package specification and GitHub repository still points to PeerSyst's. A replace all might be done when moving the repository to XRPLF GitHub account.

…arted section

maria-robobug · 2025-08-15T12:25:59Z

docs/index.page.tsx

+                <div className="col langs">
+                  <Link to="/docs/tutorials/go/">
+                    <img
+                      alt="GoLang Logo"
+                      src={require("../static/img/logos/golang.svg")}
+                      className="circled-logo"
+                    />
+                    <h5 className="btn-arrow">{translate("GoLang")}</h5>
+                  </Link>
+                </div>


Looks like this is duplicated?

maria-robobug · 2025-08-15T12:30:35Z

docs/references/client-libraries.md

@@ -13,6 +13,7 @@ For other programming languages, you can access the XRP Ledger through the [HTTP
 | Language                        | Library Name              | Get Started | API Reference | Source Code |
 |---------------------------------|---------------------------|-------------|--------------|-------------|
 | **Python**                      | `xrpl-py`                 | [Get Started Using Python](../tutorials/python/build-apps/get-started.md) | [API Reference](https://xrpl-py.readthedocs.io/) | [Repo](https://github.com/XRPLF/xrpl-py) |
+| **GoLang**                      | `xrpl-go`                 | [Get Started Using Go](../tutorials/go/build-apps/get-started.md) | [API Reference](https://pkg.go.dev/github.com/Peersyst/xrpl-go) | [Repo](https://github.com/Peersyst/xrpl-go) |


maria-robobug · 2025-08-15T12:35:51Z

docs/tutorials/go/build-apps/get-started.md

+showcase_icon: assets/img/logos/golang.svg
+---
+
+# Get Started Using GoLang Library


Suggested change

# Get Started Using GoLang Library

# Get Started Using Go Library

maria-robobug · 2025-08-15T12:38:11Z

docs/references/index.md

@@ -16,6 +16,8 @@ Use these libraries to access the XRP Ledger from your programming language of c

 {% xrpl-card title="Python" body="xrpl.py - a pure Python library" href="https://xrpl-py.readthedocs.io/" image="/img/logos/python.svg" imageAlt="Python logo" /%}

+{% xrpl-card title="GoLang" body="xrpl.go - a pure GoLang library" href="https://pkg.go.dev/github.com/Peersyst/xrpl-go" image="/img/logos/golang.svg" imageAlt="GoLang logo" /%}


Suggested change

{% xrpl-card title="GoLang" body="xrpl.go - a pure GoLang library" href="https://pkg.go.dev/github.com/Peersyst/xrpl-go" image="/img/logos/golang.svg" imageAlt="GoLang logo" /%}

{% xrpl-card title="Go" body="xrpl.go - a pure Go library" href="https://pkg.go.dev/github.com/Peersyst/xrpl-go" image="/img/logos/golang.svg" imageAlt="Go logo" /%}

maria-robobug · 2025-08-15T14:53:25Z

sidebars.yaml

@@ -469,6 +476,9 @@
            - label: Ruby Client Library
              href: https://www.rubydoc.info/gems/xrbp
              external: true
+            - label: GoLang Client Library


Suggested change

- label: GoLang Client Library

- label: Go Client Library

maria-robobug · 2025-08-15T14:54:11Z

docs/tutorials/index.md

@@ -16,7 +16,7 @@ These tutorials walk you through the basics of building a very simple XRP Ledger

 {% xrpl-card title="Python" body="Using xrpl.py, a pure Python library." href="/docs/tutorials/python/" image="/img/logos/python.svg" imageAlt="Python logo" /%}

-<br/>
+{% xrpl-card title="GoLang" body="Using xrpl-go, a pure GoLang library." href="/docs/tutorials/go/" image="/img/logos/golang.svg" imageAlt="GoLang logo" /%}


Suggested change

{% xrpl-card title="GoLang" body="Using xrpl-go, a pure GoLang library." href="/docs/tutorials/go/" image="/img/logos/golang.svg" imageAlt="GoLang logo" /%}

{% xrpl-card title="Go" body="Using xrpl-go, a pure Go library." href="/docs/tutorials/go/" image="/img/logos/golang.svg" imageAlt="Go logo" /%}

maria-robobug · 2025-08-15T14:54:56Z

docs/index.page.tsx

+                <div className="col langs">
+                  <Link to="/docs/tutorials/go/">
+                    <img
+                      alt="GoLang Logo"


Suggested change

alt="GoLang Logo"

alt="Go Logo"

maria-robobug · 2025-08-15T15:26:09Z

docs/tutorials/go/build-apps/get-started.md

+
+## Requirements
+
+Requiring Go version `1.22.0` and later.


Suggested change

Requiring Go version `1.22.0` and later.

To follow this tutorial, you should have Go version `1.22.0` or later installed.

maria-robobug · 2025-08-15T15:28:39Z

docs/tutorials/go/build-apps/get-started.md

+## Requirements
+
+Requiring Go version `1.22.0` and later.
+[Download latest Go version](https://go.dev/dl/)


Suggested change

[Download latest Go version](https://go.dev/dl/)

[Download latest Go version](https://go.dev/dl/).

maria-robobug · 2025-08-15T15:32:34Z

docs/tutorials/go/build-apps/get-started.md

+1. [Connect to the XRP Ledger.](#1-connect-to-the-xrp-ledger)
+1. [Get an account.](#2-get-account)
+1. [Query the XRP Ledger.](#3-query-the-xrp-ledger)


Suggested change

1. [Connect to the XRP Ledger.](#1-connect-to-the-xrp-ledger)

1. [Get an account.](#2-get-account)

1. [Query the XRP Ledger.](#3-query-the-xrp-ledger)

1. [Connect to the XRP Ledger.](#1.-connect-to-the-xrp-ledger)

2. [Get an account.](#2.-get-account)

3. [Query the XRP Ledger.](#3.-query-the-xrp-ledger)

maria-robobug · 2025-08-15T15:49:53Z

docs/tutorials/go/build-apps/get-started.md

+
+To make queries and submit transactions, you need to connect to the XRP Ledger. To do this with `xrpl-go`, you have two main options:
+
+1. Via `websocket`:


Suggested change

1. Via `websocket`:

1. Via WebSocket:

maria-robobug · 2025-08-15T15:50:48Z

docs/tutorials/go/build-apps/get-started.md

+
+### 2. Get account
+
+In `xrpl-go`, account creation and key management live in the wallet package, and on Testnet you can use the built-in faucet provider on your WebSocket (or RPC) client to fund a brand-new account immediately.


Suggested change

In `xrpl-go`, account creation and key management live in the wallet package, and on Testnet you can use the built-in faucet provider on your WebSocket (or RPC) client to fund a brand-new account immediately.

In `xrpl-go`, account creation and key management live in the `wallet` package, and on Testnet you can use the built-in faucet provider on your WebSocket (or RPC) client to fund a brand-new account immediately.

maria-robobug · 2025-08-15T16:52:53Z

_code-samples/batch/go/rpc/main.go

+        return
+    }
+
+    fmt.Println("✅ Batch transaction submitted")


Please avoid using emojis in the example code. Some environments may not render emojis reliably, and it keeps our examples universally readable.

oeggert · 2025-08-14T20:28:46Z

docs/index.page.tsx

+                <div className="col langs">
+                  <Link to="/docs/tutorials/go/">
+                    <img
+                      alt="GoLang Logo"
+                      src={require("../static/img/logos/golang.svg")}
+                      className="circled-logo"
+                    />
+                    <h5 className="btn-arrow">{translate("GoLang")}</h5>
+                  </Link>
+                </div>


Suggested change

<div className="col langs">

<Link to="/docs/tutorials/go/">

<img

alt="GoLang Logo"

src={require("../static/img/logos/golang.svg")}

className="circled-logo"

/>

<h5 className="btn-arrow">{translate("GoLang")}</h5>

</Link>

</div>

Remove this duplicate.

oeggert · 2025-08-15T17:58:33Z

docs/tutorials/go/build-apps/get-started.md

+html: get-started-using-golang-library.html
+parent: golang.html
+funnel: Build
+doc_type: Tutorials
+category: Get Started


Suggested change

html: get-started-using-golang-library.html

parent: golang.html

funnel: Build

doc_type: Tutorials

category: Get Started

You can remove these frontmatter values.

oeggert · 2025-08-15T17:59:49Z

docs/tutorials/go/build-apps/get-started.md

+top_nav_grouping: Get Started
+labels:
+  - Development
+showcase_icon: assets/img/logos/golang.svg


Suggested change

showcase_icon: assets/img/logos/golang.svg

oeggert · 2025-08-15T18:01:16Z

docs/tutorials/go/build-apps/index.md

+html: build-apps-in-golang.html
+parent: golang.html
+top_nav_grouping: Article Types


Suggested change

html: build-apps-in-golang.html

parent: golang.html

top_nav_grouping: Article Types

You can remove this frontmatter--it's deprecated.

oeggert · 2025-08-15T18:01:50Z

docs/tutorials/go/index.md

+html: golang.html
+parent: tutorials.html
+top_nav_grouping: Article Types


Suggested change

html: golang.html

parent: tutorials.html

top_nav_grouping: Article Types

oeggert · 2025-08-15T18:11:25Z

docs/tutorials/how-tos/send-xrp.md

@@ -328,6 +359,10 @@ To know for sure what a transaction did, you must look up the outcome of the tra
 {% code-snippet file="/_code-samples/send-xrp/php/send-xrp.php" from="// Check" language="php" /%}
 {% /tab %}

+{% tab label="GoLang" %}


Suggested change

{% tab label="GoLang" %}

{% tab label="Go" %}

oeggert · 2025-08-15T18:11:34Z

docs/tutorials/how-tos/send-xrp.md

@@ -391,6 +426,16 @@ print_r("Seed: " . $wallet->getSeed()); // Example: sp6JS7f14BuwFY8Mw6bTtLKWauoU
 ```
 {% /tab %}

+{% tab label="GoLang" %}


Suggested change

{% tab label="GoLang" %}

{% tab label="Go" %}

oeggert · 2025-08-15T18:11:56Z

docs/tutorials/how-tos/send-xrp.md

+fmt.Println("🌐 Classic Address:", wallet.ClassicAddress) // Example: r9ESeQQswbTxV8neiDTLTHXbXfUwiihyJk
+fmt.Println("🌐 Seed:", wallet.Seed) // Example: sEd7XGFGSWteam777HQHvw7vHypEWy2


Suggested change

fmt.Println("🌐 Classic Address:", wallet.ClassicAddress) // Example: r9ESeQQswbTxV8neiDTLTHXbXfUwiihyJk

fmt.Println("🌐 Seed:", wallet.Seed) // Example: sEd7XGFGSWteam777HQHvw7vHypEWy2

fmt.Println("Classic Address:", wallet.ClassicAddress) // Example: r9ESeQQswbTxV8neiDTLTHXbXfUwiihyJk

fmt.Println("Seed:", wallet.Seed) // Example: sEd7XGFGSWteam777HQHvw7vHypEWy2

oeggert · 2025-08-15T18:12:05Z

docs/tutorials/how-tos/send-xrp.md

@@ -433,6 +478,20 @@ $client = new JsonRpcClient("https://xrplcluster.com");
 ```
 {% /tab %}

+{% tab label="GoLang" %}


Suggested change

{% tab label="GoLang" %}

{% tab label="Go" %}

oeggert · 2025-08-15T18:12:14Z

docs/tutorials/how-tos/send-xrp.md

@@ -469,6 +528,20 @@ $client = new JsonRpcClient("http://localhost:5005");
 ```
 {% /tab %}

+{% tab label="GoLang" %}


Suggested change

{% tab label="GoLang" %}

{% tab label="Go" %}

maria-robobug · 2025-08-18T10:04:11Z

_code-samples/get-started/README.md

@@ -8,3 +8,4 @@ For more context, see the Get Started tutorial for your preferred language:
 - [Java](https://xrpl.org/get-started-using-java.html)
 - [JavaScript](https://xrpl.org/get-started-using-javascript.html)
 - [PHP](https://xrpl.org/get-started-using-php.html)
+- [GoLang](https://xrpl.org/get-started-using-golang.html)


Suggested change

- [GoLang](https://xrpl.org/get-started-using-golang.html)

- [Go](https://xrpl.org/get-started-using-go.html)

maria-robobug · 2025-08-18T12:31:36Z

docs/tutorials/go/build-apps/get-started.md

+    ```go
+	// 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
+	}
+    ```


Since we have a code sample for this (_code-samples/get-started/go/base/ws/main.go), please use the code-snippet tag to reference the snippet instead.

For example:

1. Via WebSocket: {% code-snippet file="/_code-samples/get-started/go/base/ws/main.go" from="func main()" language="go" /%}

maria-robobug · 2025-08-18T12:32:11Z

docs/tutorials/go/build-apps/get-started.md

+2. Via `RPC`: 
+    ```go
+    cfg, err := rpc.NewClientConfig("https://s.altnet.rippletest.net:51234/")
+    if err != nil {
+        panic(err)
+      }
+
+    // Initiate the network client
+    client := rpc.NewClient(cfg)
+    ```


Suggested change

2. Via `RPC`:

```go

cfg, err := rpc.NewClientConfig("https://s.altnet.rippletest.net:51234/")

if err != nil {

panic(err)

}

// Initiate the network client

client := rpc.NewClient(cfg)

```

2. Via RPC:

{% code-snippet file="/_code-samples/get-started/go/base/rpc/main.go" from="func main()" language="go" /%}

maria-robobug · 2025-08-18T12:39:57Z

_code-samples/get-started/go/base/ws/main.go

+    client := websocket.NewClient(websocket.NewClientConfig().
+        WithHost("wss://s.altnet.rippletest.net:51233"))


Shouldn't we add the WithFaucetProvider() function here since we are connecting to Testnet?

Suggested change

client := websocket.NewClient(websocket.NewClientConfig().

WithHost("wss://s.altnet.rippletest.net:51233"))

client := websocket.NewClient(websocket.NewClientConfig().

WithHost("wss://s.altnet.rippletest.net:51233").

WithFaucetProvider(faucet.NewTestnetFaucetProvider()),

)

maria-robobug · 2025-08-18T12:42:58Z

_code-samples/get-started/go/base/rpc/main.go

+
+func main() {
+    // Define the network client configuration
+    cfg, err := rpc.NewClientConfig("https://s.altnet.rippletest.net:51234/")


Shouldn't we add the WithFaucetProvider() function here since we are connecting to Testnet?

Suggested change

cfg, err := rpc.NewClientConfig("https://s.altnet.rippletest.net:51234/")

cfg, err := rpc.NewClientConfig(

"https://s.altnet.rippletest.net:51234/",

rpc.WithFaucetProvider(faucet.NewTestnetFaucetProvider()),

)

maria-robobug · 2025-08-18T13:03:18Z

docs/tutorials/go/build-apps/get-started.md

+
+Now that you know how to use `xrpl.js` to connect to the XRP Ledger, get an account, and look up information about it, you can also:
+
+- [Send XRP](../../how-tos/send-xrp.md).


Suggested change

- [Send XRP](../../how-tos/send-xrp.md).

- [Send XRP](../../how-tos/send-xrp.md).

{% raw-partial file="/docs/_snippets/common-links.md" /%}

maria-robobug · 2025-08-18T13:41:51Z

docs/tutorials/go/build-apps/get-started.md

+
+You can query the XRP Ledger to get information about [a specific account](../../../references/http-websocket-apis/public-api-methods/account-methods/index.md), [a specific transaction](../../../references/http-websocket-apis/public-api-methods/transaction-methods/tx.md), the state of a [current or a historical ledger](../../../references/http-websocket-apis/public-api-methods/ledger-methods/index.md), and [the XRP Ledger's decentralized exchange](../../../references/http-websocket-apis/public-api-methods/path-and-order-book-methods/index.md). You need to make these queries, among other reasons, to look up account info to follow best practices for [reliable transaction submission](../../../concepts/transactions/reliable-transaction-submission.md).
+
+You can use either the Client's `request()` method to access the XRP Ledger's [WebSocket API](../../../references/http-websocket-apis/api-conventions/request-formatting.md). For example:


Not sure this actually describes the Go code correctly. Change to:

Suggested change

You can use either the Client's `request()` method to access the XRP Ledger's [WebSocket API](../../../references/http-websocket-apis/api-conventions/request-formatting.md). For example:

Use the Client's `Request()` method to access the XRP Ledger's [WebSocket API](../../../references/http-websocket-apis/api-conventions/request-formatting.md). For example:

maria-robobug · 2025-08-18T15:12:01Z

docs/tutorials/go/build-apps/get-started.md

+  ```go
+  import 	"github.com/Peersyst/xrpl-go/xrpl/websocket"
+  const PublicServer = "wss://xrplcluster.com/"
+  client := websocket.NewClient(websocket.NewClientConfig().WithHost(PublicServer))
+  ```


Suggested change

```go

import "github.com/Peersyst/xrpl-go/xrpl/websocket"

const PublicServer = "wss://xrplcluster.com/"

client := websocket.NewClient(websocket.NewClientConfig().WithHost(PublicServer))

```

```go

import "github.com/Peersyst/xrpl-go/xrpl/websocket"

const PUBLIC_SERVER = "wss://xrplcluster.com/"

func main() {

client := websocket.NewClient(websocket.NewClientConfig().WithHost(PUBLIC_SERVER))

// ... custom code goes here

}

maria-robobug · 2025-08-18T15:12:56Z

docs/tutorials/go/build-apps/get-started.md

+  ```go
+  import 	"github.com/Peersyst/xrpl-go/xrpl/websocket"
+  const MyServer := "ws://localhost:6006/"
+  client := websocket.NewClient(websocket.NewClientConfig().WithHost(MyServer))
+  ```


Suggested change

```go

import "github.com/Peersyst/xrpl-go/xrpl/websocket"

const MyServer := "ws://localhost:6006/"

client := websocket.NewClient(websocket.NewClientConfig().WithHost(MyServer))

```

```go

import "github.com/Peersyst/xrpl-go/xrpl/websocket"

const MY_SERVER = "ws://localhost:6006/"

func main() {

client := websocket.NewClient(websocket.NewClientConfig().WithHost(MY_SERVER))

// ... custom code goes here

}

maria-robobug · 2025-08-18T15:16:56Z

docs/tutorials/go/build-apps/get-started.md

+
+## Keep on Building
+
+Now that you know how to use `xrpl.js` to connect to the XRP Ledger, get an account, and look up information about it, you can also:


Suggested change

Now that you know how to use `xrpl.js` to connect to the XRP Ledger, get an account, and look up information about it, you can also:

Now that you know how to use `xrpl-go` to connect to the XRP Ledger, get an account, and look up information about it, you can also:

maria-robobug · 2025-08-18T15:17:28Z

docs/tutorials/go/build-apps/get-started.md

+
+{% code-snippet file="/_code-samples/get-tx/go/main.go" from="// Get the latest validated ledger" language="go" /%}
+
+Or use the [`websocket` or `rpc` packages](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/websocket#Client.GetAccountChannels) getter methods:


Suggested change

Or use the [`websocket` or `rpc` packages](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/websocket#Client.GetAccountChannels) getter methods:

Or, use the getter methods from the [`websocket`](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/websocket) or [`rpc`](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/rpc) packages:

maria-robobug · 2025-08-18T15:24:32Z

docs/tutorials/go/build-apps/get-started.md

+
+In `xrpl-go`, account creation and key management live in the wallet package, and on Testnet you can use the built-in faucet provider on your WebSocket (or RPC) client to fund a brand-new account immediately.
+
+Here we spin up a Testnet‐connected WebSocket client, generate a fresh ED25519 wallet, then fund it automatically via the public faucet.


Suggested change

Here we spin up a Testnet‐connected WebSocket client, generate a fresh ED25519 wallet, then fund it automatically via the public faucet.

On Testnet, you can fund a new ED25519 account like this:

maria-robobug · 2025-08-18T15:27:16Z

docs/tutorials/go/build-apps/get-started.md

+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
+}
+


Suggested change

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

}

We've already shown the user how to connect with the client(s) in the previous step, so we probably don't need to show this again.

maria-robobug · 2025-08-18T16:10:48Z

_code-samples/batch/go/rpc/main.go

+    fmt.Println("⏳ Autofilling flattened multi batch transaction...")
+    if err := client.AutofillMultisigned(&flattenedMultiBatchTx, 1); err != nil {
+        fmt.Println("Autofill error:", err)
+        return


Could we use panic(err) for all error handling in these code examples? I know it's not good practice for production code, but for documentation examples it should be fine.

maria-robobug

Thanks for the contribution! Added comments and suggestions.

banasa44 added 14 commits July 17, 2025 12:02

feat(_code-samples): WiP add tx examples skeleton

61dd7a8

feat(_code-samples): WiP add go tx examples implementation

ff5b5ab

feat(_code-samples): WiP add go tx examples implementation and get-st…

877ed4e

…arted section

refactor(_code-samples): remove Go WebSocket use-ticket example

d970039

feat(docs): add GoLang tutorial link and logo to the documentation index

7e700c0

feat(docs): add xrpl-go GoLang package to XRPLF documentation site

82b9769

refactor(_code-samples): remove README.md file from code samples

7baaa03

refactor(_code-samples): move use-tickets example

2e45eb7

chore(docs): small fixes/changes in go tutorials docs

2aa7d5f

chore(docs): small style and comments changes and fixes

79ed25b

chore(docs): small fixes

0ab8593

chore(docs): small fixes

1009242

feat(samples): add go examples, secure signing and send a memo

6de921c

chore(samples): replace tab for 4 spaces

e1153eb

banasa44 marked this pull request as ready for review July 23, 2025 08:57

oeggert requested a review from maria-robobug August 11, 2025 18:57

maria-robobug reviewed Aug 15, 2025

View reviewed changes

oeggert requested changes Aug 15, 2025

View reviewed changes

maria-robobug reviewed Aug 18, 2025

View reviewed changes

maria-robobug requested changes Aug 18, 2025

View reviewed changes

	\| GoLang \| `xrpl-go` \| [Get Started Using Go](../tutorials/go/build-apps/get-started.md) \| [API Reference](https://pkg.go.dev/github.com/Peersyst/xrpl-go) \| [Repo](https://github.com/Peersyst/xrpl-go) \|
	\| Go \| `xrpl-go` \| [Get Started Using Go](../tutorials/go/build-apps/get-started.md) \| [API Reference](https://pkg.go.dev/github.com/Peersyst/xrpl-go) \| [Repo](https://github.com/Peersyst/xrpl-go) \|

	# Get Started Using GoLang Library
	# Get Started Using Go Library

		@@ -16,6 +16,8 @@ Use these libraries to access the XRP Ledger from your programming language of c

		{% xrpl-card title="Python" body="xrpl.py - a pure Python library" href="https://xrpl-py.readthedocs.io/" image="/img/logos/python.svg" imageAlt="Python logo" /%}

		{% xrpl-card title="GoLang" body="xrpl.go - a pure GoLang library" href="https://pkg.go.dev/github.com/Peersyst/xrpl-go" image="/img/logos/golang.svg" imageAlt="GoLang logo" /%}

	{% xrpl-card title="GoLang" body="xrpl.go - a pure GoLang library" href="https://pkg.go.dev/github.com/Peersyst/xrpl-go" image="/img/logos/golang.svg" imageAlt="GoLang logo" /%}
	{% xrpl-card title="Go" body="xrpl.go - a pure Go library" href="https://pkg.go.dev/github.com/Peersyst/xrpl-go" image="/img/logos/golang.svg" imageAlt="Go logo" /%}

	{% xrpl-card title="GoLang" body="Using xrpl-go, a pure GoLang library." href="/docs/tutorials/go/" image="/img/logos/golang.svg" imageAlt="GoLang logo" /%}
	{% xrpl-card title="Go" body="Using xrpl-go, a pure Go library." href="/docs/tutorials/go/" image="/img/logos/golang.svg" imageAlt="Go logo" /%}

	Requiring Go version `1.22.0` and later.
	To follow this tutorial, you should have Go version `1.22.0` or later installed.

	[Download latest Go version](https://go.dev/dl/)
	[Download latest Go version](https://go.dev/dl/).


		To make queries and submit transactions, you need to connect to the XRP Ledger. To do this with `xrpl-go`, you have two main options:

		1. Via `websocket`:


		### 2. Get account

		In `xrpl-go`, account creation and key management live in the wallet package, and on Testnet you can use the built-in faucet provider on your WebSocket (or RPC) client to fund a brand-new account immediately.

	html: build-apps-in-golang.html
	parent: golang.html
	top_nav_grouping: Article Types

	html: golang.html
	parent: tutorials.html
	top_nav_grouping: Article Types

		fmt.Println("🌐 Classic Address:", wallet.ClassicAddress) // Example: r9ESeQQswbTxV8neiDTLTHXbXfUwiihyJk
		fmt.Println("🌐 Seed:", wallet.Seed) // Example: sEd7XGFGSWteam777HQHvw7vHypEWy2

	- [GoLang](https://xrpl.org/get-started-using-golang.html)
	- [Go](https://xrpl.org/get-started-using-go.html)

		client := websocket.NewClient(websocket.NewClientConfig().
		WithHost("wss://s.altnet.rippletest.net:51233"))


		Now that you know how to use `xrpl.js` to connect to the XRP Ledger, get an account, and look up information about it, you can also:

		- [Send XRP](../../how-tos/send-xrp.md).


		You can query the XRP Ledger to get information about [a specific account](../../../references/http-websocket-apis/public-api-methods/account-methods/index.md), [a specific transaction](../../../references/http-websocket-apis/public-api-methods/transaction-methods/tx.md), the state of a [current or a historical ledger](../../../references/http-websocket-apis/public-api-methods/ledger-methods/index.md), and [the XRP Ledger's decentralized exchange](../../../references/http-websocket-apis/public-api-methods/path-and-order-book-methods/index.md). You need to make these queries, among other reasons, to look up account info to follow best practices for [reliable transaction submission](../../../concepts/transactions/reliable-transaction-submission.md).

		You can use either the Client's `request()` method to access the XRP Ledger's [WebSocket API](../../../references/http-websocket-apis/api-conventions/request-formatting.md). For example:

	You can use either the Client's `request()` method to access the XRP Ledger's [WebSocket API](../../../references/http-websocket-apis/api-conventions/request-formatting.md). For example:
	Use the Client's `Request()` method to access the XRP Ledger's [WebSocket API](../../../references/http-websocket-apis/api-conventions/request-formatting.md). For example:


		## Keep on Building

		Now that you know how to use `xrpl.js` to connect to the XRP Ledger, get an account, and look up information about it, you can also:

	Now that you know how to use `xrpl.js` to connect to the XRP Ledger, get an account, and look up information about it, you can also:
	Now that you know how to use `xrpl-go` to connect to the XRP Ledger, get an account, and look up information about it, you can also:


		{% code-snippet file="/_code-samples/get-tx/go/main.go" from="// Get the latest validated ledger" language="go" /%}

		Or use the [`websocket` or `rpc` packages](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/websocket#Client.GetAccountChannels) getter methods:

Add xrpl-go examples and references to xrpl-dev-portal #3211

Are you sure you want to change the base?

Add xrpl-go examples and references to xrpl-dev-portal #3211

Uh oh!

Conversation

banasa44 commented Jul 23, 2025

Add xrpl-go examples and references to xrpl-dev-portal

Description

Changes

Notes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maria-robobug Aug 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maria-robobug Aug 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maria-robobug Aug 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maria-robobug Aug 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maria-robobug Aug 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maria-robobug Aug 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

maria-robobug Aug 15, 2025 •

edited

Loading

maria-robobug Aug 15, 2025 •

edited

Loading

maria-robobug Aug 15, 2025 •

edited

Loading

maria-robobug Aug 18, 2025 •

edited

Loading

maria-robobug Aug 18, 2025 •

edited

Loading

maria-robobug Aug 18, 2025 •

edited

Loading

maria-robobug Aug 18, 2025 •

edited

Loading

maria-robobug Aug 18, 2025 •

edited

Loading

	Or use the [`websocket` or `rpc` packages](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/websocket#Client.GetAccountChannels) getter methods:
	Or, use the getter methods from the [`websocket`](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/websocket) or [`rpc`](https://pkg.go.dev/github.com/Peersyst/[email protected]/xrpl/rpc) packages:


		In `xrpl-go`, account creation and key management live in the wallet package, and on Testnet you can use the built-in faucet provider on your WebSocket (or RPC) client to fund a brand-new account immediately.

		Here we spin up a Testnet‐connected WebSocket client, generate a fresh ED25519 wallet, then fund it automatically via the public faucet.

	Here we spin up a Testnet‐connected WebSocket client, generate a fresh ED25519 wallet, then fund it automatically via the public faucet.
	On Testnet, you can fund a new ED25519 account like this: