Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.formance.com/llms.txt

Use this file to discover all available pages before exploring further.

In Numscript, a posting models the movement of an amount of an asset from one account to another. Postings are wrapped in a transaction to ensure that they are applied atomically.

​
Defining a posting

A posting is defined as followed: 
send [COIN 100] (
  source = @world
  destination = @users:001
)
Square brackets describe the asset being moved using the Formance’s Unambiguous Monetary Notation (UMN). It is composed of the asset type optionally followed by a scaling value, and the amount. In this case, the asset type is COIN with no scaling value, and the amount is 100.

​
Postings with balance

You can omit the amount of an asset in a posting and replace it with a *. This is used when you want to move all of the assets of the accounts in the source block to the ones destination block. 
send [USD/2 *] (
  source = @order:1234
  destination = {
    10% to @platform:fees
    remaining to @merchant:5678
  }
)
Here, we are moving all of the USD/2 asset from the @order:1234 account. 10% of the @order:1234 balance is moved to the @platform:fees account, and the remaining 90% is moved to the @merchant:5678 account.