# pieceMetadata

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

Defined in: [derive.ts:317](https://github.com/FilOzone/synapse-sdk/blob/a3c661408bf8b3cb47684059a425c07b9ae50a64/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/)