Class Builder

sdk/java/src/main/java/com/chain/api/Asset.java:175–327

Asset.Builder utilizes the builder pattern to create Asset objects. The following attributes are required to be set: #rootXpubs, #quorum.

   * The following attributes are required to be set: {@link #rootXpubs}, {@link #quorum}.
   */
  public static class Builder {
    /**
     * User specified, unique identifier.
     */
    public String alias;

    /**
     * User-specified, arbitrary/unstructured data visible across blockchain networks.<br>
     * Version 1 assets specify the definition in their issuance programs, rendering the definition immutable.
     */
    public Map<String, Object> definition;

    /**
     * User-specified, arbitrary/unstructured data local to the asset's originating core.
     */
    public Map<String, Object> tags;

    /**
     * The list of keys used to create the issuance program for the asset.<br>
     * Signatures from these keys are required for issuing units of the asset.<br>
     * <strong>Must set with {@link #addRootXpub(String)} or {@link #setRootXpubs(List)} before calling {@link #create(Client)}.</strong>
     */
    @SerializedName("root_xpubs")
    public List<String> rootXpubs;

    /**
     * The number of keys required to sign an issuance of the asset.<br>
     * <strong>Must set with {@link #setQuorum(int)} before calling {@link #create(Client)}.</strong>
     */
    public int quorum;

    /**
     * Unique identifier used for request idempotence.
     */
    @SerializedName("client_token")
    private String clientToken;

    /**
     * Default constructor initializes the list of keys.
     */
    public Builder() {
      this.rootXpubs = new ArrayList<>();
    }

    /**
     * Creates an asset object.
     * @param client client object that makes request to the core
     * @return an asset object
     * @throws APIException This exception is raised if the api returns errors while creating the asset.
     * @throws BadURLException This exception wraps java.net.MalformedURLException.
     * @throws ConnectivityException This exception is raised if there are connectivity issues with the server.
     * @throws HTTPException This exception is raised when errors occur making http requests.
     * @throws JSONException This exception is raised due to malformed json requests or responses.
     */
    public Asset create(Client client) throws ChainException {
      return client.singletonBatchRequest(
          "create-asset", Arrays.asList(this), Asset.class, APIException.class);
    }