Package org.xrpl.xrpl4j.codec.addresses

Class AddressCodec

java.lang.Object
org.xrpl.xrpl4j.codec.addresses.AddressCodec
public class AddressCodec extends Object
A Codec for encoding/decoding various address primitives.

  • Constructor Details

    • AddressCodec

      public AddressCodec()

  • Method Details

    • getInstance

      public static AddressCodec getInstance()

    • encodeAccountId

      public Address encodeAccountId(UnsignedByteArray accountId)
      Encode an XRPL AccountID to a Base58Check encoded String.
      Parameters:
      accountId - An UnsignedByteArray containing the AccountID to be encoded.
      Returns:
      The Base58 representation of accountId, as an Address.

    • decodeAccountId

      public UnsignedByteArray decodeAccountId(Address accountId)
      Decode a Base58Check encoded XRPL AccountID.
      Parameters:
      accountId - The Base58 encoded AccountID to be decoded, as an Address.
      Returns:
      An UnsignedByteArray containing the decoded AccountID.
      See Also:
      • "https://xrpl.org/base58-encodings.html"

    • encodeNodePublicKey

      @Deprecated public String encodeNodePublicKey(UnsignedByteArray publicKey)
      Deprecated.
      Prefer PublicKeyCodec.encodeNodePublicKey(UnsignedByteArray).
      Encode an XRPL Node Public Key to a Base58Check encoded String.
      Parameters:
      publicKey - An UnsignedByteArray containing the public key to be encoded.
      Returns:
      The Base58 representation of publicKey.

    • decodeNodePublicKey

      @Deprecated public UnsignedByteArray decodeNodePublicKey(String publicKey)
      Deprecated.
      Prefer PublicKeyCodec.decodeNodePublicKey(String).
      Decode a Base58Check encoded XRPL Node Public Key.
      Parameters:
      publicKey - The Base58 encoded public key to be decoded.
      Returns:
      An UnsignedByteArray containing the decoded public key.
      See Also:
      • "https://xrpl.org/base58-encodings.html"

    • classicAddressToXAddress

      public XAddress classicAddressToXAddress(Address classicAddress, com.google.common.primitives.UnsignedInteger tag, boolean test)
      Converts an XRPL Classic Address and Destination Tag to an X-Address.
      Parameters:
      classicAddress - A String containing the classic address.
      tag - The destination tag of the address.
      test - true if the X-Address should be encoded for Testnet, false if it should be encoded for Mainnet.
      Returns:
      The X-Address representation of the classic address and destination tag.

    • classicAddressToXAddress

      public XAddress classicAddressToXAddress(Address classicAddress, boolean test)
      Converts an XRPL Classic Address with no Destination Tag to an X-Address.
      Parameters:
      classicAddress - An Address containing the classic address.
      test - true if the X-Address should be encoded for Testnet, false if it should be encoded for Mainnet.
      Returns:
      The X-Address representation of the classic address, as an XAddress.

    • classicAddressToXAddress

      public XAddress classicAddressToXAddress(Address classicAddress, Optional<com.google.common.primitives.UnsignedInteger> tag, boolean test)
      Converts an XRPL Classic Address and and optional Destination Tag to an X-Address.
      Parameters:
      classicAddress - An Address containing the classic address.
      tag - The destination tag of the address.
      test - true if the X-Address should be encoded for Testnet, false if it should be encoded for Mainnet.
      Returns:
      The X-Address representation of the classic address and destination tag, as an XAddress.

    • encodeXAddress

      public XAddress encodeXAddress(UnsignedByteArray accountId, Optional<com.google.common.primitives.UnsignedInteger> tag, boolean test)
      Encodes and AccountID, destination tag, and the XRPL network into an X-Address.
      Parameters:
      accountId - An UnsignedByteArray containing an XRPL AccountID.
      tag - (Optional) The destination tag of the account.
      test - true if the X-Address should be encoded for Testnet, false if it should be encoded for Mainnet.
      Returns:
      The X-Address representation of the AccountID and destination tag, as an XAddress.

    • xAddressToClassicAddress

      public ClassicAddress xAddressToClassicAddress(XAddress xAddress)
      Decodes an X-Address to a Classic Address and Destination Tag.
      Parameters:
      xAddress - The XAddress to be decoded.
      Returns:
      The ClassicAddress decoded from xAddress.

    • decodeXAddress

      public DecodedXAddress decodeXAddress(XAddress xAddress)
      Decodes an X-Address to an AccountID, destination tag, and a boolean for XRPL-testnet or XRPL-mainnet.
      Parameters:
      xAddress - The XAddress to be decoded.
      Returns:
      The DecodedXAddress decoded from xAddress.

    • isValidXAddress

      public boolean isValidXAddress(XAddress xAddress)
      Tests if the given X-Address is a valid X-Address.
      Parameters:
      xAddress - A potentially valid XAddress.
      Returns:
      true if the given address is a valid X-Address, false if not.

    • isValidClassicAddress

      public boolean isValidClassicAddress(Address address)
      Tests if the given Address is a valid Classic Address.
      Parameters:
      address - A potentially valid classic Address.
      Returns:
      true if the given address is a valid Classic Address, false if not.