# Synapse

**Synapse SDK - Main entry point**

## Example

```ts twoslash
import { Synapse } from '@filoz/synapse-sdk'
```

## Namespaces

| Namespace | Description |
| ------ | ------ |
| [asChain](/reference/filoz/synapse-sdk/synapse/namespaces/aschain/toc/) | - |

## Classes

| Class | Description |
| ------ | ------ |
| [Synapse](/reference/filoz/synapse-sdk/synapse/classes/synapse/) | Class for interacting with Filecoin storage and other on-chain services |

## Interfaces

| Interface | Description |
| ------ | ------ |
| [Chain](/reference/filoz/synapse-sdk/synapse/interfaces/chain/) | - |
| [ContextCreateContextsOptions](/reference/filoz/synapse-sdk/synapse/interfaces/contextcreatecontextsoptions/) | - |
| [CreateContextsOptions](/reference/filoz/synapse-sdk/synapse/interfaces/createcontextsoptions/) | - |
| [DataSetData](/reference/filoz/synapse-sdk/synapse/interfaces/datasetdata/) | Data set data returned from the API |
| [DataSetInfo](/reference/filoz/synapse-sdk/synapse/interfaces/datasetinfo/) | Data set information returned from Warm Storage contract |
| [DataSetPieceData](/reference/filoz/synapse-sdk/synapse/interfaces/datasetpiecedata/) | Individual data set piece data from API |
| [EnhancedDataSetInfo](/reference/filoz/synapse-sdk/synapse/interfaces/enhanceddatasetinfo/) | Enhanced data set information with chain details and clear ID separation |
| [PDPProvider](/reference/filoz/synapse-sdk/synapse/interfaces/pdpprovider/) | - |
| [PieceFetchOptions](/reference/filoz/synapse-sdk/synapse/interfaces/piecefetchoptions/) | - |
| [PieceRecord](/reference/filoz/synapse-sdk/synapse/interfaces/piecerecord/) | Canonical representation of a piece within a data set. |
| [PieceRetriever](/reference/filoz/synapse-sdk/synapse/interfaces/pieceretriever/) | PieceRetriever interface for fetching pieces from various sources Returns standard Web API Response objects for flexibility |
| [PieceStatus](/reference/filoz/synapse-sdk/synapse/interfaces/piecestatus/) | Status information for a piece stored on a provider Note: Proofs are submitted for entire data sets, not individual pieces. The timing information reflects the data set's status. |
| [PreflightInfo](/reference/filoz/synapse-sdk/synapse/interfaces/preflightinfo/) | Preflight information for storage uploads |
| [ProviderSelectionResult](/reference/filoz/synapse-sdk/synapse/interfaces/providerselectionresult/) | Result of provider selection and data set resolution |
| [SettlementResult](/reference/filoz/synapse-sdk/synapse/interfaces/settlementresult/) | Settlement result from settling a payment rail |
| [StorageContextCallbacks](/reference/filoz/synapse-sdk/synapse/interfaces/storagecontextcallbacks/) | Callbacks for storage service creation process |
| [StorageContextCreateOptions](/reference/filoz/synapse-sdk/synapse/interfaces/storagecontextcreateoptions/) | Options for creating or selecting a storage context |
| [StorageInfo](/reference/filoz/synapse-sdk/synapse/interfaces/storageinfo/) | Comprehensive storage service information |
| [StorageOptions](/reference/filoz/synapse-sdk/synapse/interfaces/storageoptions/) | Storage service options |
| [StorageServiceOptions](/reference/filoz/synapse-sdk/synapse/interfaces/storageserviceoptions/) | Options for creating or selecting a storage context |
| [SynapseFromClientOptions](/reference/filoz/synapse-sdk/synapse/interfaces/synapsefromclientoptions/) | - |
| [SynapseOptions](/reference/filoz/synapse-sdk/synapse/interfaces/synapseoptions/) | Options for initializing the Synapse instance |
| [UploadCallbacks](/reference/filoz/synapse-sdk/synapse/interfaces/uploadcallbacks/) | - |
| [UploadOptions](/reference/filoz/synapse-sdk/synapse/interfaces/uploadoptions/) | Options for uploading individual pieces to an existing storage context |
| [UploadResult](/reference/filoz/synapse-sdk/synapse/interfaces/uploadresult/) | Upload result information |
| [UploadTask](/reference/filoz/synapse-sdk/synapse/interfaces/uploadtask/) | Upload task tracking |

## Type Aliases

| Type Alias | Description |
| ------ | ------ |
| [DataSetId](/reference/filoz/synapse-sdk/synapse/type-aliases/datasetid/) | - |
| [DownloadOptions](/reference/filoz/synapse-sdk/synapse/type-aliases/downloadoptions/) | Download options Currently empty, reserved for future options |
| [FilecoinNetworkType](/reference/filoz/synapse-sdk/synapse/type-aliases/filecoinnetworktype/) | Supported Filecoin network types |
| [MetadataEntry](/reference/filoz/synapse-sdk/synapse/type-aliases/metadataentry/) | - |
| [MetadataObject](/reference/filoz/synapse-sdk/synapse/type-aliases/metadataobject/) | - |
| [PieceCID](/reference/filoz/synapse-sdk/synapse/type-aliases/piececid/) | - |
| [PrivateKey](/reference/filoz/synapse-sdk/synapse/type-aliases/privatekey/) | - |
| [RailInfo](/reference/filoz/synapse-sdk/synapse/type-aliases/railinfo/) | - |
| [ServiceProvider](/reference/filoz/synapse-sdk/synapse/type-aliases/serviceprovider/) | - |
| [TokenAmount](/reference/filoz/synapse-sdk/synapse/type-aliases/tokenamount/) | - |
| [TokenIdentifier](/reference/filoz/synapse-sdk/synapse/type-aliases/tokenidentifier/) | Token identifier for balance queries |

## Variables

| Variable | Description |
| ------ | ------ |
| [calibration](/reference/filoz/synapse-sdk/synapse/variables/calibration/) | - |
| [DEFAULT\_CHAIN](/reference/filoz/synapse-sdk/synapse/variables/default_chain/) | - |
| [devnet](/reference/filoz/synapse-sdk/synapse/variables/devnet/) | - |
| [mainnet](/reference/filoz/synapse-sdk/synapse/variables/mainnet/) | - |
| [METADATA\_KEYS](/reference/filoz/synapse-sdk/synapse/variables/metadata_keys/) | Common metadata keys |
| [SIZE\_CONSTANTS](/reference/filoz/synapse-sdk/synapse/variables/size_constants/) | - |
| [TIME\_CONSTANTS](/reference/filoz/synapse-sdk/synapse/variables/time_constants/) | - |
| [TOKENS](/reference/filoz/synapse-sdk/synapse/variables/tokens/) | Token identifiers |

## Functions

| Function | Description |
| ------ | ------ |
| [asChain](/reference/filoz/synapse-sdk/synapse/functions/aschain/) | - |
| [formatUnits](/reference/filoz/synapse-sdk/synapse/functions/formatunits/) | - |
| [getChain](/reference/filoz/synapse-sdk/synapse/functions/getchain/) | - |
| [parseUnits](/reference/filoz/synapse-sdk/synapse/functions/parseunits/) | - |