Presets¶

Presets are predefined configurations that control the full stamping pipeline through a single parameter. Instead of manually specifying storage, encryption, anchors, and trust thresholds, you pick a preset that matches your use case.

Using Presets¶

CLI¶

primestamp stamp document.pdf -p casual
primestamp stamp contract.pdf -p archival
primestamp stamp patent.pdf -p maximum

Python API¶

from primestamp import StampEngine

engine = StampEngine.with_new_identity()

# The preset parameter configures everything
stamp = engine.create_stamp(content, preset="standard")

Listing Available Presets¶

primestamp presets

This displays a table with all presets and their settings.

Preset Reference¶

Casual¶

For blog posts, ideas, quick timestamps.

Setting	Value
Storage	IPFS
Encryption	None
Anchors	Solana
Trust threshold	2

The casual preset prioritizes speed and low cost. Solana provides sub-second confirmation times. There is no encryption -- content is assumed to be public. The trust threshold of 2 is met by a single confirmed Solana anchor (weight 2).

stamp = engine.create_stamp(content, preset="casual")

Standard¶

For professional documents.

Setting	Value
Storage	IPFS
Encryption	None
Anchors	Ethereum, Polygon
Trust threshold	5

The standard preset uses Ethereum (weight 4) and Polygon (weight 2) for a combined maximum trust score of 6. The threshold of 5 requires at least Ethereum to confirm, since Polygon alone (weight 2) would not meet it. This ensures a high-security anchor is always included.

stamp = engine.create_stamp(content, preset="standard")

Archival¶

For research and legal documents.

Setting	Value
Storage	Arweave
Encryption	AES-256-GCM
Anchors	Bitcoin, Ethereum, RFC 3161
Trust threshold	10

The archival preset is designed for documents that need long-term preservation and legal standing. Arweave provides permanent storage. AES-256-GCM encryption protects content at rest. Three anchor types are used:

Bitcoin (weight 5) -- The most secure and widely recognized blockchain
Ethereum (weight 4) -- Second-strongest blockchain anchor
RFC 3161 (weight 4) -- Legally recognized timestamp authority

The maximum possible trust score is 13 (5 + 4 + 4). The threshold of 10 requires at least two of the three anchors to confirm.

stamp = engine.create_stamp(content, preset="archival")

Maximum¶

For patents and high-stakes documents.

Setting	Value
Storage	Arweave
Encryption	AES-256-GCM
Anchors	Bitcoin, Ethereum, Arweave, RFC 3161, Certificate Transparency
Trust threshold	15

The maximum preset throws everything at the problem. Five anchor types provide deep redundancy:

Bitcoin (weight 5)
Ethereum (weight 4)
Arweave (weight 3)
RFC 3161 (weight 4)
Certificate Transparency (weight 2)

The maximum possible trust score is 18 (5 + 4 + 3 + 4 + 2). The threshold of 15 requires at least four of the five anchors to confirm, ensuring the stamp remains valid even if one anchor chain becomes temporarily unavailable.

stamp = engine.create_stamp(content, preset="maximum")

Comparison Table¶

Preset	Storage	Encryption	Anchors	Threshold	Max Score	Use Case
`casual`	IPFS	None	Solana	2	2	Blog posts, ideas
`standard`	IPFS	None	Ethereum + Polygon	5	6	Professional docs
`archival`	Arweave	AES-256-GCM	Bitcoin + Ethereum + RFC 3161	10	13	Research, legal
`maximum`	Arweave	AES-256-GCM	Bitcoin + Ethereum + Arweave + RFC 3161 + CT	15	18	Patents, high-stakes

Custom Configuration¶

If none of the presets fit your needs, you can specify each parameter individually:

from primestamp import StampEngine, AnchorType, StorageMode, EncryptionAlgorithm

engine = StampEngine.with_new_identity()

stamp = engine.create_stamp(
    content,
    storage_mode=StorageMode.IPFS,
    encryption=EncryptionAlgorithm.CHACHA20_POLY1305,
    anchors=[AnchorType.BITCOIN, AnchorType.SOLANA],
    trust_threshold=7,
    version="2.0.0",
)

Preset overrides individual settings

When you pass preset=, it overrides storage_mode, encryption, anchors, and trust_threshold. If you need to customize just one setting, skip the preset and specify all parameters explicitly.