principal

Entry point for building post conditions. Starts the post condition builder chain by specifying the principal (address) the condition applies to.

The Pc builder uses a chainable API pattern: PRINCIPAL → [AMOUNT] → CODE → ASSET.

---

Usage

import { Pc, Cl } from '@stacks/transactions';

// STX post condition — principal will send exactly 10,000 microSTX
Pc.principal('STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6')
  .willSendEq(10000)
  .ustx();

// Fungible token post condition
Pc.principal('STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6')
  .willSendGte(1000)
  .ft('ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-contract', 'token-name');

// Non-fungible token post condition
Pc.principal('STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6')
  .willSendAsset()
  .nft('ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.nft-contract::nft-name', Cl.uint(1));

// Contract principal
Pc.principal('ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.my-contract')
  .willSendLte(5000)
  .ustx();

Notes

• The address can be a standard principal (ST...) or a contract principal (address.contract-name).

• After calling Pc.principal(), chain one of the amount/comparator methods, then finalize with an asset method.

Reference Link

---

Signature

function principal(principal: AddressString | ContractIdString): PartialPcWithPrincipal;

---

Returns

PartialPcWithPrincipal

An intermediate builder object. Chain with one of the following methods:

Method	Description
.willSendEq(amount)	Amount sent will be equal to the specified amount
.willSendLte(amount)	Amount sent will be less than or equal to the specified amount
.willSendLt(amount)	Amount sent will be less than the specified amount
.willSendGte(amount)	Amount sent will be greater than or equal to the specified amount
.willSendGt(amount)	Amount sent will be greater than the specified amount
.willSendAsset()	The principal will send the NFT asset
.willNotSendAsset()	The principal will not send the NFT asset

After the comparator, finalize with an asset method:

Method	Description
.ustx()	STX post condition (returns StxPostCondition)
.ft(contractId, tokenName)	Fungible token post condition (returns FungiblePostCondition)
.nft(assetName, assetId)	Non-fungible token post condition (returns NonFungiblePostCondition)

---

Parameters

principal (required)

• Type: AddressString | ContractIdString

The principal address or contract identifier the post condition applies to.