Package io.fliqa.client.interledger.model

Class WalletAddress

java.lang.Object
io.fliqa.client.interledger.model.WalletAddress
public class WalletAddress extends Object
Represents a wallet address for Interledger Open Payments operations.

A wallet address is a URL that identifies a specific wallet or account within the Interledger network. It serves as the primary identifier for sending and receiving payments through the Open Payments protocol.

Wallet addresses are typically hosted by Rafiki instances and follow the URI format. They are used to discover wallet capabilities, create payment resources, and identify parties in payment transactions.

Example wallet addresses:

  • "https://ilp.interledger-test.dev/alice"
  • "https://ilp.interledger-test.dev/bob"
  • "https://wallet.example.com/user123"

This class is immutable and thread-safe. The wallet address is validated during construction to ensure it's a valid URI.

Since:
1.0
See Also:

  • Field Details

    • paymentPointer

      public final URI paymentPointer
      The URI representing the wallet address.

      This is the actual wallet address URI that identifies the wallet within the Interledger network. It's used for payment operations, resource discovery, and wallet identification.

      The URI must be valid and typically follows the HTTPS scheme for security purposes.

  • Constructor Details

    • WalletAddress

      public WalletAddress(String address)
      Constructs a new WalletAddress from a string URI.

      This constructor parses the provided address string into a URI and validates that it's not null. The string should be a valid URI format.

      Parameters:
      address - the wallet address as a string (e.g., "https://ilp.interledger-test.dev/alice")
      Throws:
      IllegalArgumentException - if the address is null
      IllegalArgumentException - if the address is not a valid URI format

    • WalletAddress

      public WalletAddress(URI address)
      Constructs a new WalletAddress from a URI object.

      This constructor accepts a pre-parsed URI object and validates that it's not null. This is useful when you already have a URI object from other operations.

      Parameters:
      address - the wallet address as a URI object
      Throws:
      IllegalArgumentException - if the address is null

  • Method Details