# pieceMetadata

> **pieceMetadata**(`ref`, `options`): [`PieceMetadata`](/reference/filoz/keysmith/type-aliases/piecemetadata/)

Defined in: [derive.ts:317](https://github.com/FilOzone/synapse-sdk/blob/68e30a2a5457180e60a5579eb5ecff90b65894b3/packages/keysmith/src/derive.ts#L317)

Piece FEE envelope metadata entries.

Everything a reader needs travels with the piece, so a copy opens wherever
replication or repair puts it.

## Parameters

| Parameter | Type |
| ------ | ------ |
| `ref` | [`KeyspaceRef`](/reference/filoz/keysmith/interfaces/keyspaceref/) |
| `options` | \{ `salt`: `` `0x${string}` ``; `scope?`: `string`; \} |
| `options.salt` | `` `0x${string}` `` |
| `options.scope?` | `string` |

## Returns

[`PieceMetadata`](/reference/filoz/keysmith/type-aliases/piecemetadata/)