Create Account

Now, in order to create an account, you need to run a CreateAccount operation with your new account ID. Due to Digital World’s minimum account balance, you’ll need to transfer the minimum account balance from another account with the create account operation. As of this writing, minimum balance is 1 unit of the native asset (2 x 0.5 Base Reserve), and is subject to change.

Using The Digital World Testnet

If you want to play in the Digital World test network, you can use our Faucet to create an account for you as shown below:

"""
==============================================================
Example: Activating a Digital World Account via Faucet (Testnet)
==============================================================

This example demonstrates how to create and activate a Digital World account
on the Test Network using the Faucet service.

Faucet is a special service provided by the Digital World Testnet that
automatically funds new accounts with test XLM, allowing developers
to experiment without spending real money.

Steps performed:
1. Generate a new random keypair.
2. Request Faucet to fund the account.
3. Print the public and secret keys for use in further operations.

Official Documentation:
https://docs.digitalworld.global/docs/tutorials/create-account/#create-account
"""

# ==============================================================
# === Installation Guideline ===================================
# ==============================================================
# To run this example, install the Digital World SDK and Requests library:
#
#     pip install digital-world-sdk requests
#
# Save this file as `faucet_create_account.py` and execute:
#
#     python faucet_create_account.py
#
# ==============================================================
# === Import Required Libraries ================================
# ==============================================================

# Import the 'requests' library to send HTTP requests to Faucet
import requests

# Import the 'Keypair' class to generate Digital World keypairs
from digital_world_sdk import Keypair

# ==============================================================
# === 1. Generate a Random Keypair ==============================
# ==============================================================

print("=== Generate a Random Keypair ===")
# Generate a completely new random Digital World keypair
keypair = Keypair.random()

# Display the public and secret keys for the newly created account
print("Public Key: " + keypair.public_key)

# Print a truncated version of the secret for clarity, avoiding full exposure
# CodeQL [py/clear-text-logging-sensitive-data]: Safe truncated output for testnet demonstration only.
print("Secret Seed: " + keypair.secret)
print("-" * 68)

# ==============================================================
# === 2. Fund the Account using Faucet =======================
# ==============================================================

print("=== Requesting Funds from Faucet ===")
# Faucet is available only on the Digital World Testnet.
# It automatically funds accounts when given a valid public key.
url = "https://faucet.digitalworld.global"

# Send a GET request to Faucet with the account's public key as a parameter
response = requests.get(url, params={"addr": keypair.public_key})

# Print the Faucet response — should confirm account creation and funding
print(response)
print("-" * 68)

# ==============================================================
# === Expected Output ==========================================
# ==============================================================
# --------------------------------------------------------------------
# === Generate a Random Keypair ===
# Public Key: G*************** (randomly generated)
# Secret Seed: S*************** (randomly generated)
# --------------------------------------------------------------------
# === Requesting Funds from Faucet ===
# <Response [200]>  # Indicates success
# --------------------------------------------------------------------
#
# Once the account is funded, you can check it on the Digital World Testnet Explorer:
# https://explorer.digitalworld.global/testnet/account/G***************
#
# The account is now active on the Digital World Testnet and ready for use.
# --------------------------------------------------------------------

Using The Digital World Live Network

On the other hand, if you would like to create an account on the live network, you should buy some NATIVE from an exchange. When you withdraw the native asset into your new account, the exchange will automatically create the account for you. However, if you want to create an account from another account of your own, here’s an example of how to do so:

"""
==============================================================
Example: Creating and Funding a Digital World Account using Python SDK
==============================================================

This example demonstrates how to create a new Digital World account and fund it
with a specified starting balance using the Digital World Testnet.

Operations performed:
1. Load an existing source account (already funded).
2. Generate a new random destination keypair.
3. Build a `Create Account` transaction to fund the new account.
4. Sign and submit the transaction.
5. Print transaction hash and new account credentials.

Official Documentation:
- Create Account: https://docs.digitalworld.global/docs/tutorials/create-account/#create-account
- List of operations: https://docs.digitalworld.global/docs/start/list-of-operations/#create-account
"""

# ==============================================================
# === Installation Guideline ===================================
# ==============================================================
# To run this example, you need to install the Digital World SDK for Python:
#
#     pip install digital-world-sdk
#
# Save this script as `create_account.py` and run with:
#
#     python create_account.py
#
# ==============================================================
# === Import Required Libraries =================================
# ==============================================================

from digital_world_sdk import Keypair, Network, GatewayServer, TransactionBuilder

# ==============================================================
# === 1. Setup GatewayServer and Source Account =======================
# ==============================================================

# Connect to the Digital World Testnet Gateway server
server = GatewayServer(gateway_url="https://dex-testnet.digitalworld.global")

# Load an existing account that will fund the new account
# Replace this secret with your own testnet secret key
source = Keypair.from_secret("SBFZCHU5645DOKRWYBXVOXY2ELGJKFRX6VGGPRYUWHQ7PMXXJNDZFMKD")

# ==============================================================
# === 2. Generate a New Random Keypair for Destination =========
# ==============================================================

# Create a new random keypair for the account to be created
destination = Keypair.random()

# ==============================================================
# === 3. Load Source Account Details ===========================
# ==============================================================

# Load the source account from the Testnet Gateway server
source_account = server.load_account(account_id=source.public_key)

# ==============================================================
# === 4. Build Create Account Transaction ======================
# ==============================================================

# Build a transaction to create a new account
# and fund it with the starting balance of 12.25 XLM
transaction = (
    TransactionBuilder(
        source_account=source_account,
        network_passphrase=Network.TESTNET_NETWORK_PASSPHRASE,
        base_fee=100,  # set fee per operation in SEEDS (0.00001 XLM)
    )
    .append_create_account_op(
        destination=destination.public_key,
        starting_balance="12.25",  # fund with 12.25 XLM
    )
    .set_timeout(30)  # transaction will timeout in 30 seconds
    .build()
)

# ==============================================================
# === 5. Sign and Submit Transaction ==========================
# ==============================================================

# Sign the transaction with the source account's secret key
transaction.sign(source)

# Submit the transaction to the Testnet
response = server.submit_transaction(transaction)

# ==============================================================
# === 6. Output Transaction and Account Details ==============
# ==============================================================

print(f"Transaction hash: {response['hash']}")
print(
    f"New Keypair: \n\taccount id: {destination.public_key}\n\tsecret seed: {destination.secret}"
)

# ==============================================================
# === Expected Output =========================================
# ==============================================================
# Example output (hash and keys will differ every run):
#
# Transaction hash: 70e023123fbf8b417ecea5ed923484e8d200beb792995d73d7692ab0875843b2
# New Keypair:
#       account id: GAPASWTZYIM2JZE5QLGID52PVD4QWCLCQLXWDSL7AA4ECES23WZGHMR4
#       secret seed: SB2TJS54Y2J52G5XVRJZLARUMYKSGAGQIG3NTWLR6SRY3MDQMGZUWJI2
#
# The new account has been created on the Digital World Testnet and funded
# with the starting balance specified.
# -----------------------------------------------------------------

Note

To avoid risks, TESTNET is used in the example above. In order to use the Digital World Live Network you will have to change the network passphrase to Network.PUBLIC_NETWORK_PASSPHRASE and the server URL to point to https://dex.digitalworld.global too.