Setting Limits on Transfers

Note

You should restart the application after updating parameters or attributes.

Setting limits with the relation type

There are two types of attribute relation type for transactions:

ENTITLEMENT TRANSFER

This type is to control a simple transfer from a seller's attribute into a buyers attribute. The maximum amount transferred is limited by the value in the seller's attribute. You will always create this kind of relation for any transfer, but you can modify it with the second relation type.

TRANSACTION RESTRICTION

This type allows you to set up a seller attribute to set a per-transaction limit on transfers from a different seller attribute. You must still create an entitlement transfer to control the actual transfer.

Transaction restriction relations are useful if you want to allow the value of the seller's attribute to be negative, or if you want to enforce a minimum entitlement for the seller.

Example

Suppose we want to transfer a water entitlement from a seller's Stored Water attribute into a buyer's Stored water attribute. We would set up the following attribute type relation:

In this case, the maximum amount of water that can be transferred from the seller to the buyer is the total amount in the seller's Stored Water attribute.

Now we decide that instead of being limited by the value of the seller's Stored Water attribute, we would rather have a fixed per-transfer limit of 2000 ML. We could set up a second relation as follows:

In this case, both the attributes are on the seller's property. The limit of 2000 ML is manually stored in the Stored Water Limit and controls how much can be transferred from the Stored Water attribute during any transfer. Note that nothing is transferred into or out of the Stored Water Limit, it's only purpose is to hold the transfer restriction.

Setting a percentage transfer limit

You can specify a percentage transferred in the attribute type relation. If this is set to anything less than 100%, the full amount of the transfer is taken from the seller attribute, but only the specified percentage of that amount is added to the buyer attribute.

This may be used to account for losses or costs involved in the transfer process.

The percent transferred does not apply to TRANSACTION RESTRICTION relation types.